Win32_SoundDevice-Klasse
Die Win32_SoundDeviceWMI-Klasse stellt die Eigenschaften eines Soundgeräts auf einem Computersystem mit Windows dar.
Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.
Syntax
[Dynamic, Provider("CIMWin32"), UUID("{8502C50C-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SoundDevice : CIM_LogicalDevice
{
uint16 Availability;
string Caption;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
uint16 DMABufferSize;
boolean ErrorCleared;
string ErrorDescription;
datetime InstallDate;
uint32 LastErrorCode;
string Manufacturer;
uint32 MPU401Address;
string Name;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string ProductName;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
};
Member
Die Win32_SoundDevice-Klasse verfügt über folgende Membertypen:
Methoden
Die Win32_SoundDevice-Klasse verfügt über diese Methoden.
Methode | BESCHREIBUNG |
---|---|
Zurücksetzen | Nicht implementiert. Informationen zum Implementieren dieser Methode finden Sie in der Reset-Methode in CIM_LogicalDevice. |
SetPowerState | Nicht implementiert. Informationen zum Implementieren dieser Methode finden Sie unter der SetPowerState-Methode in CIM_LogicalDevice. |
Eigenschaften
Die Win32_SoundDevice-Klasse verfügt über diese Eigenschaften.
-
Verfügbarkeit
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")
Verfügbarkeit und status des Geräts.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
-
-
Sonstiges (1)
-
Unbekannt (2)
-
Running/Full Power (3)
-
"Running" oder "Full Power"
-
Warnung (4)
-
In Test (5)
-
Nicht zutreffend (6)
-
Ausschalten (7)
-
Off Line (8)
-
Off Duty (9)
-
Herabgestuft (10)
-
Nicht installiert (11)
-
Installationsfehler (12)
-
Stromsparen – Unbekannt (13)
-
Es ist bekannt, dass sich das Gerät in einem Energiesparmodus befindet, aber seine genaue status ist unbekannt.
-
Stromsparmodus – Energiesparmodus (14)
-
Das Gerät befindet sich im Energiesparmodus, funktioniert aber weiterhin und kann eine leistungseinbußen aufweisen.
-
Energiesparmodus – Standby (15)
-
Das Gerät funktioniert nicht, konnte aber schnell auf Volle gebracht werden.
-
Stromversorgung (16)
-
Stromsparen – Warnung (17)
-
Das Gerät befindet sich in einem Warnzustand, aber auch im Energiesparmodus.
-
Angehalten (18)
-
Das Gerät ist angehalten.
-
Nicht bereit (19)
-
Das Gerät ist nicht bereit.
-
Nicht konfiguriert (20)
-
Das Gerät ist nicht konfiguriert.
-
Stilllegung (21)
-
Das Gerät ist ruhig.
Caption
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Kurze Beschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
ConfigManagerErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Win32 Configuration Manager Fehlercode.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Dieses Gerät funktioniert ordnungsgemäß. (0)
Das Gerät funktioniert ordnungsgemäß.
Dieses Gerät ist nicht ordnungsgemäß konfiguriert. (1)
Das Gerät ist nicht ordnungsgemäß konfiguriert.
Windows kann den Treiber für dieses Gerät nicht laden. (2)
Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder Ihr System verfügt möglicherweise über wenig Arbeitsspeicher oder andere Ressourcen. (3)
Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder das System verfügt über wenig Arbeitsspeicher oder andere Ressourcen.
Dieses Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder Ihre Registrierung ist möglicherweise beschädigt. (4)
Das Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder die Registrierung ist möglicherweise beschädigt.
Der Treiber für dieses Gerät benötigt eine Ressource, die Windows nicht verwalten kann. (5)
Der Treiber für das Gerät erfordert eine Ressource, die Windows nicht verwalten kann.
Die Startkonfiguration für dieses Gerät ist in Konflikt mit anderen Geräten. (6)
Die Startkonfiguration für das Gerät ist in Konflikt mit anderen Geräten.
Filter kann nicht gefiltert werden. (7)
Das Treiberladeprogramm für das Gerät fehlt. (8)
Das Treiberladeprogramm für das Gerät fehlt.
Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch meldet. (9)
Das Gerät funktioniert nicht ordnungsgemäß. Die steuernde Firmware meldet die Ressourcen für das Gerät fälschlicherweise.
Dieses Gerät kann nicht gestartet werden. (10)
Das Gerät kann nicht gestartet werden.
Bei diesem Gerät ist ein Fehler aufgetreten. (11)
Fehler beim Gerät.
Dieses Gerät kann nicht genügend freie Ressourcen finden, die es verwenden kann. (12)
Das Gerät kann nicht genügend kostenlose Ressourcen finden, um es zu verwenden.
Windows kann die Ressourcen dieses Geräts nicht überprüfen. (13)
Windows kann die Ressourcen des Geräts nicht überprüfen.
Dieses Gerät kann erst dann ordnungsgemäß funktionieren, wenn Sie den Computer neu starten. (14)
Das Gerät kann erst dann ordnungsgemäß funktionieren, wenn der Computer neu gestartet wird.
Dieses Gerät funktioniert nicht ordnungsgemäß, da wahrscheinlich ein Problem mit erneuter Enumeration vorliegt. (15)
Das Gerät funktioniert aufgrund eines möglichen Problems mit erneuter Enumeration nicht ordnungsgemäß.
Windows kann nicht alle von diesem Gerät verwendeten Ressourcen identifizieren. (16)
Windows kann nicht alle Ressourcen identifizieren, die das Gerät verwendet.
Dieses Gerät fragt nach einem unbekannten Ressourcentyp. (17)
Das Gerät fordert einen unbekannten Ressourcentyp an.
Installieren Sie die Treiber für dieses Gerät neu. (18)
Gerätetreiber müssen neu installiert werden.
Fehler beim Verwenden des VxD-Ladeprogramms. (19)
Möglicherweise ist Ihre Registrierung beschädigt. (20)
Die Registrierung kann beschädigt sein.
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie Ihre Hardwaredokumentation. Windows entfernt dieses Gerät. (21)
Systemfehler. Wenn das Ändern des Gerätetreibers unwirksam ist, lesen Sie die Hardwaredokumentation. Windows entfernt das Gerät.
Dieses Gerät ist deaktiviert. (22)
Das Gerät ist deaktiviert.
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie Ihre Hardwaredokumentation. (23)
Systemfehler. Wenn das Ändern des Gerätetreibers unwirksam ist, lesen Sie die Hardwaredokumentation.
Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder hat nicht alle Treiber installiert. (24)
Das Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder hat nicht alle Treiber installiert.
Windows richtet dieses Gerät weiterhin ein. (25)
Windows richtet das Gerät weiterhin ein.
Windows richtet dieses Gerät weiterhin ein. (26)
Windows richtet das Gerät weiterhin ein.
Dieses Gerät verfügt nicht über eine gültige Protokollkonfiguration. (27)
Das Gerät verfügt nicht über eine gültige Protokollkonfiguration.
Die Treiber für dieses Gerät sind nicht installiert. (28)
Gerätetreiber sind nicht installiert.
Dieses Gerät ist deaktiviert, da die Firmware des Geräts nicht die erforderlichen Ressourcen bereitgestellt hat. (29)
Das Gerät ist deaktiviert. Die Gerätefirmware hat nicht die erforderlichen Ressourcen bereitgestellt.
Dieses Gerät verwendet eine Interrupt Request -Ressource (IRQ), die von einem anderen Gerät verwendet wird. (30)
Das Gerät verwendet eine IRQ-Ressource, die von einem anderen Gerät verwendet wird.
Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden kann. (31)
Das Gerät funktioniert nicht ordnungsgemäß. Windows kann die erforderlichen Gerätetreiber nicht laden.
ConfigManagerUserConfig
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
CreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: CIM_Key
Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung eines instance verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht die -Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Beschreibung
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Description")
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
DeviceID
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Überschreiben ("DeviceId"), Key, MaxLen (260), MappingStrings ("Win32Registry| SYSTEM\\CurrentControlSet\\control\\MediaResources\\wave| DeviceID")
Eindeutiger Bezeichner des Soundgeräts.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
DMABufferSize
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("WMI"), Einheiten ("Kilobytes")
Größe des Puffers für direkten Speicherzugriff.
Beispiel: 4
ErrorCleared
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
Wenn true, wird der in LastErrorCode gemeldete Fehler jetzt gelöscht.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
ErrorDescription
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Freiformzeichenfolge, die weitere Informationen zu dem in LastErrorCode aufgezeichneten Fehler und Informationen zu möglichen Korrekturmaßnahmen bereitstellt.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")
Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
LastErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Letzter Fehlercode, der vom logischen Gerät gemeldet wurde.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Manufacturer
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("WMI")
Hersteller des Soundgeräts.
Beispiel: "Creative Labs"
MPU401Address
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("WMI")
Start-E/A-Adresse, die dem MPU-401-Port des Soundgeräts zugewiesen ist.
Beispiel: 300
Name
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Name")
Bezeichnung, unter der das Objekt bekannt ist. Bei unterklassigen Klassen kann die Eigenschaft als Schlüsseleigenschaft überschrieben werden.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
PNPDeviceID
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Windows Plug & Play Gerätebezeichner des logischen Geräts.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Beispiel: "*PNP030b"
PowerManagementCapabilities
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
Array der spezifischen energiebezogenen Funktionen eines logischen Geräts.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Unbekannt (0)
Nicht unterstützt (1)
Deaktiviert (2)
Aktiviert (3)
Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.
Energiesparmodi werden automatisch eingegeben (4)
Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.
Power State Settable (5)
Die SetPowerState-Methode wird unterstützt. Diese Methode befindet sich in der übergeordneten CIM_LogicalDevice Klasse und kann implementiert werden. Weitere Informationen finden Sie unter Entwerfen von MOF-Klassen (Managed Object Format).
Power Cycling Wird unterstützt (6)
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 (Power Cycle) festgelegt ist.
Timed Power On Supported (7)
Unterstützte zeitlimitierte Power-On
Die SetPowerState-Methode kann aufgerufen werden, wobei der PowerState-Parameter auf 5 (Power Cycle) und Time auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall festgelegt ist, um ein einschalten zu können.
PowerManagementSupported
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Wenn TRUE, kann das Gerät energieverwaltet werden (kann in den Anhaltemodus versetzt werden usw.). Die -Eigenschaft gibt nicht an, dass Energieverwaltungsfeatures derzeit aktiviert sind, nur, dass das logische Gerät energieverwaltungsfähig ist.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
ProductName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API| Multimedia-Strukturen| WAVEOUTCAPS|szPname")
Produktname des Soundgeräts.
Beispiel: "Creative Labs SoundBlaster AWE64PNP"
Status
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann beim Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
Folgende Werte sind gültig:
OK ("OK")
Fehler ("Fehler")
Degraded ("Degraded")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Beenden ("Wird beendet")
Dienst ("Dienst")
Gestresst ("Gestresst")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
StatusInfo
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.3")
Status des logischen Geräts. Wenn diese Eigenschaft nicht für das logische Gerät gilt, sollte der Wert 5 (Nicht zutreffend) verwendet werden.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Sonstiges (1)
Unbekannt (2)
Aktiviert (3)
Deaktiviert (4)
Nicht zutreffend (5)
SystemCreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagiert ("CIM_System. CreationClassName"), CIM_Key
Wert der CreationClassName-Eigenschaft des Bereichscomputers.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Systemname
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagiert ("CIM_System. Name"), CIM_Key
Name des Bereichssystems.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Bemerkungen
Die Win32_SoundDevice-Klasse wird von CIM_LogicalDevice abgeleitet.
Beispiele
Das PowerShell-Beispiel Listenssoundkarteneigenschaften ruft Informationen zu allen soundkarten ab, die auf einem Computer installiert sind.
Im folgenden VBScript-Beispiel werden Informationen zu allen Soundkarten abgerufen, die auf einem Computer installiert sind.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_SoundDevice")
For Each objItem in colItems
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo "Device ID: " & objItem.DeviceID
Wscript.Echo "DMA Buffer Size: " & objItem.DMABufferSize
Wscript.Echo "Manufacturer: " & objItem.Manufacturer
Wscript.Echo "MPU 401 Address: " & objItem.MPU401Address
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "PNP Device ID: " & objItem.PNPDeviceID
Wscript.Echo "Product Name: " & objItem.ProductName
Wscript.Echo "Status Information: " & objItem.StatusInfo
Next
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|
Siehe auch