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
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM _ LogicalDevice

Computersystemhardwareklassen