Win32 _ SoundDevice-Klasse
Die WMI-Klasse Win32 _ SoundDevice stellt die Eigenschaften eines Soundgeräts auf einem Computersystem dar, auf dem Windows ausgeführt wird.
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 diese Typen von Membern:
Methoden
Die Win32 _ SoundDevice-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Zurücksetzen | Nicht implementiert. Informationen zum Implementieren dieser Methode finden Sie unter 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 | Operational State | 003.5", "MIB. IETF | HOST-RESOURCES-MIB.hrDeviceStatus")
Verfügbarkeit und Status des Geräts.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
-
-
Andere (1)
-
Unbekannt (2)
-
Running/Full Power (3) (Ausführen/Vollbetrieb (3))
-
Running or Full Power
-
Warnung (4)
-
In Test (5)
-
Nicht zutreffend (6)
-
Ausschalten (7)
-
Off Line (8)
-
Off-Duty (9)
-
Heruntergestuft (10)
-
Nicht installiert (11)
-
Installationsfehler (12)
-
Energiesparen – Unbekannt (13)
-
Das Gerät befindet sich bekanntermaßen im Energiesparmodus, aber sein genauer Status ist unbekannt.
-
Energiesparmodus – Energiesparmodus (14)
-
Das Gerät befindet sich im Energiesparzustand, funktioniert aber weiterhin und kann eine beeinträchtigte Leistung aufweisen.
-
Energiesparmodus – Standby (15)
-
Das Gerät funktioniert nicht, kann aber schnell voll ausgepowert werden.
-
Stromzyklus (16)
-
Energiesparen – Warnung (17)
-
Das Gerät befindet sich in einem Warnungszustand, aber auch im Energiesparmodus.
-
Angehalten (18)
-
Das Gerät wird angehalten.
-
Nicht bereit (19)
-
Das Gerät ist nicht bereit.
-
Nicht konfiguriert (20)
-
Das Gerät ist nicht konfiguriert.
-
Still (21)
-
Das Gerät ist still.
Caption
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Kurze Beschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
ConfigManagerErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Win32 Konfigurations-Manager Fehlercode.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
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 ü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 können. (5)
Der Treiber für das Gerät erfordert eine Ressource, die Windows nicht verwalten können.
Die Startkonfiguration für dieses Gerät ist mit anderen Geräten in Konflikt. (6)
Bei der Startkonfiguration für das Gerät tritt ein Konflikt mit anderen Geräten auf.
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 berichtet falsch über die Ressourcen für das Gerät.
Dieses Gerät kann nicht gestartet werden. (10)
Das Gerät kann nicht gestartet werden.
Fehler bei diesem Gerät. (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 freie Ressourcen für die Verwendung finden.
Windows können die Ressourcen dieses Geräts nicht überprüfen. (13)
Windows können die Ressourcen des Geräts nicht überprüfen.
Dieses Gerät funktioniert erst dann ordnungsgemäß, wenn Sie Ihren Computer neu starten. (14)
Das Gerät funktioniert erst dann ordnungsgemäß, wenn der Computer neu gestartet wird.
Dieses Gerät funktioniert nicht ordnungsgemäß, da wahrscheinlich ein Problem mit der erneuten Enumeration vor liegt. (15)
Das Gerät funktioniert aufgrund eines möglichen Problems mit der erneuten Enumeration nicht ordnungsgemäß.
Windows können nicht alle Ressourcen identifizieren, die dieses Gerät verwendet. (16)
Windows können 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-Ladeers. (19)
Ihre Registrierung ist möglicherweise beschädigt. (20)
Die Registrierung ist möglicherweise beschädigt.
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 ineffektiv 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 ineffektiv ist, lesen Sie die Hardwaredokumentation.
Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder verfügt nicht über alle installierten Treiber. (24)
Das Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder verfügt nicht über alle installierten Treiber.
Windows wird dieses Gerät weiterhin eingerichtet. (25)
Windows Das Gerät wird weiterhin eingerichtet.
Windows wird dieses Gerät weiterhin eingerichtet. (26)
Windows Das Gerät wird weiterhin eingerichtet.
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 ihm nicht die erforderlichen Ressourcen zur Verfügung hat. (29)
Das Gerät ist deaktiviert. Die Gerätefirmware hat nicht die erforderlichen Ressourcen zur Verfügung stellt.
Dieses Gerät verwendet eine IrQ-Ressource (Interrupt Request), die von einem anderen Gerät verwendet wird. (30)
Das Gerät verwendet eine IRQ-Ressource, die ein anderes Gerät verwendet.
Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden können. (31)
Das Gerät funktioniert nicht ordnungsgemäß. Windows die erforderlichen Gerätetreiber können nicht geladen werden.
ConfigManagerUserConfig
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
True gibt an, dass das Gerät eine benutzerdefinierte Konfiguration verwendet.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
CreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: _ CIM-Taste
Der Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung einer -Instanz verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht die -Eigenschaft, dass alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.
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: Override ("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 den direkten Speicherzugriff.
Beispiel: 4
ErrorCleared
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass der in LastErrorCode gemeldete Fehler jetzt nicht mehr angezeigt wird.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
ErrorDescription
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Freiformzeichenfolge, die weitere Informationen über den in LastErrorCode aufgezeichneten Fehler und Informationen zu eventuell ergriffenen Korrekturmaßnahmen enthält.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installation date")
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 vom logischen Gerät gemeldeter Fehlercode.
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: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Name")
Bezeichnung, unter der das Objekt bekannt ist. Bei Unterklassen kann die Eigenschaft überschrieben werden, um eine Schlüsseleigenschaft zu sein.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
PNPDeviceID
-
Datentyp: Zeichenfolge
-
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 Funktionssatz ist unbekannt, oder die Informationen sind nicht verfügbar.
Automatisch eingegebene Energiesparmodi (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 Managed Object Format -Klassen (MOF).
Power-Bike unterstützt (6)
Die SetPowerState-Methode kann mit dem PowerState-Parameter aufgerufen werden, der auf 5 (Power Cycle) festgelegt ist.
Timed Power On Supported (7)
Timed Power-On Supported
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 (Power Cycle) und Time auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Ein-/Aus-Setzen festgelegt ist.
PowerManagementSupported
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass das Gerät energieverwendt verwaltet werden kann (kann in den Modus "Aussetzen" wechseln und so weiter). Die -Eigenschaft gibt nicht an, dass energieverwaltungsfeatures derzeit aktiviert sind, sondern nur, dass das logische Gerät energieverwaltungsfähig ist.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
ProductName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Multimedia Structures | WAVEOUTCAPS | szPname")
Produktname des Soundgeräts.
Beispiel: "Creative Labs SoundBlaster AWE64PNP"
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Aktueller Status des Objekts. Es können verschiedene betriebsbereite und nicht betriebsbereite Status definiert werden. Folgende Betriebsstatus sind möglich: "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, aber es wird in naher Zukunft ein Fehler vorhergesagt). Nicht operative Status sind: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann während der Spiegelung eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. 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")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Beenden ("Wird beendet")
Dienst ("Dienst")
1600000000000
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Verlorenes Komma ("Verlorenes Komma")
StatusInfo
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Operational State | 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 _ LogicalDevicegeerbt.
Andere (1)
Unbekannt (2)
Aktiviert (3)
Deaktiviert (4)
Nicht zutreffend (5)
SystemCreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel
Wert der CreationClassName-Eigenschaft des Bereichscomputers.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
Systemname
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Weitergegeben ("_ CIM-System.Name"), _ CIM-Schlüssel
Name des Bereichssystems.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
Hinweise
Die Win32 _ SoundDevice-Klasse wird von CIM _ LogicalDeviceabgeleitet.
Beispiele
Im PowerShell-Beispiel List Sound Card Properties (Listen von Soundkarteneigenschaften) werden Informationen zu allen sound cards abgerufen, 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) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|