DEVICE_STATE_XXX Konstanten

Die DEVICE_STATE_XXX Konstanten geben den aktuellen Zustand eines Audioendpunktgeräts an.

Konstante/Wert BESCHREIBUNG
DEVICE_STATE_ACTIVE
0x00000001
Das Audioendpunktgerät ist aktiv. Das heißt, der Audioadapter, der eine Verbindung mit dem Endpunktgerät herstellt, ist vorhanden und aktiviert. Wenn das Endpunktgerät an eine Buchse am Adapter angeschlossen ist, wird das Endpunktgerät außerdem angeschlossen.
DEVICE_STATE_DISABLED
0x00000002
Das Audioendpunktgerät ist deaktiviert. Der Benutzer hat das Gerät in der Windows-Multimedia-Systemsteuerung deaktiviert, Mmsys.cpl. Weitere Informationen finden Sie in den Hinweisen.
DEVICE_STATE_NOTPRESENT
0x00000004
Das Audioendpunktgerät ist nicht vorhanden, da der Audioadapter, der eine Verbindung mit dem Endpunktgerät herstellt, aus dem System entfernt wurde oder der Benutzer das Adaptergerät in Geräte-Manager deaktiviert hat.
DEVICE_STATE_UNPLUGGED
0x00000008
Das Audioendpunktgerät ist nicht angeschlossen. Der Audioadapter, der die Buchse für das Endpunktgerät enthält, ist vorhanden und aktiviert, aber das Endpunktgerät ist nicht an die Buchse angeschlossen. Nur ein Gerät mit Klinkenerkennung kann sich in diesem Zustand befinden. Weitere Informationen zur Jack-Presence-Erkennung finden Sie unter Audioendpunktgeräte.
DEVICE_STATEMASK_ALL
0x0000000F
Enthält Audioendpunktgeräte in allen Zuständen aktiv, deaktiviert, nicht vorhanden und nicht angeschlossen.

Bemerkungen

Die Methoden IMMDeviceEnumerator::EnumAudioEndpoints, IMMDevice::GetState und IMMNotificationClient::OnDeviceStateChanged verwenden die DEVICE_STATE_XXX Konstanten. Mit diesen Methoden können Clients Informationen zu Endpunktgeräten abrufen, die sich in einem der Zustände befinden, die durch die DEVICE_STATE_XXX Konstanten dargestellt werden.

Ein Client kann jedoch einen Stream (z. B. durch Abrufen einer IAudioClient-Schnittstelle für das Gerät) nur auf einem Gerät öffnen, das sich im DEVICE_STATE_ACTIVE Zustand befindet.

Die Windows-Multimedia-Systemsteuerung Mmsys.cpl zeigt die Audioendpunkte im System an. Das Deaktivieren eines Geräts in Mmsys.cpl blendet das Gerät vor den Geräteermittlungsmechanismen in übergeordneten Audio-APIs aus. Es werden jedoch keine Streamobjekte ungültig, die ein Client möglicherweise vor der Deaktivierung des Geräts instanziiert hat. Wenn beispielsweise ein Stream auf dem Gerät wiedergegeben wird, wenn der Benutzer ihn in Mmsys.cpl deaktiviert, wird der Stream weiterhin unterbrechungsfrei wiedergegeben.

Im Gegensatz dazu entfernt das Deaktivieren eines Geräts in Geräte-Manager das Gerät effektiv aus dem System.

Um Mmsys.cpl zum Anzeigen der Renderinggeräte zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster, und geben Sie den folgenden Befehl ein:

Steuern mmsys.cpl,,0

Geben Sie den folgenden Befehl ein, um die Erfassungsgeräte anzuzeigen:

Steuern mmsys.cpl,1

Alternativ können Sie die Renderinggeräte oder die Aufnahmegeräte in Mmsys.cpl anzeigen, indem Sie mit der rechten Maustaste auf das Lautsprechersymbol im Benachrichtigungsbereich klicken, der sich auf der rechten Seite der Taskleiste befindet, und Wiedergabegeräte oder Aufzeichnungsgeräte auswählen.

Mmsys.cpl zeigt immer Endpunktgeräte an, die sich im DEVICE_STATE_ACTIVE Zustand befinden. Darüber hinaus kann es so konfiguriert werden, dass deaktivierte und nicht verbundene Geräte angezeigt werden.

Um Endpunktgeräte anzuzeigen, die sich in den DEVICE_STATE_DISABLED- und DEVICE_STATE_NOTPRESENT-Status befinden, klicken Sie mit der rechten Maustaste in das fenster Mmsys.cpl, und wählen Sie die Option Deaktivierte Geräte anzeigen aus.

Um Endpunktgeräte anzuzeigen, die sich im DEVICE_STATE_UNPLUGGED Zustand befinden, klicken Sie mit der rechten Maustaste in das fenster Mmsys.cpl, und wählen Sie die Option Getrennte Geräte anzeigen aus.

Um nur Endpunktgeräte anzuzeigen, die sich im DEVICE_STATE_ACTIVE Zustand befinden, deaktivieren Sie die Optionen Deaktivierte Geräte anzeigen und Getrennten Geräte anzeigen .

Um ein Endpunktgerät in Mmsys.cpl zu aktivieren oder zu deaktivieren, klicken Sie auf Wiedergabe oder Aufzeichnung, je nachdem, ob es sich bei dem Gerät um ein Wiedergabe- oder Aufzeichnungsgerät handelt. Wählen Sie als Nächstes das Gerät aus, und klicken Sie auf Eigenschaften. Wählen Sie im Fenster Eigenschaften neben Gerätenutzung entweder Dieses Gerät verwenden (aktivieren) oder Dieses Gerät nicht verwenden (deaktivieren) aus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Mmdeviceapi.h

Siehe auch

Kernaudiokonstanten

IMMDevice::GetState

IMMDeviceEnumerator-Schnittstelle

IMMDeviceEnumerator::EnumAudioEndpoints

IMMNotificationClient::OnDeviceStateChanged