IMMDeviceEnumerator-Schnittstelle (mmdeviceapi.h)

Die IMMDeviceEnumerator-Schnittstelle bietet Methoden zum Auflisten von Multimediageräteressourcen. In der aktuellen Implementierung der MMDevice-API können von dieser Schnittstelle nur Audioendpunkte aufgelistet werden. Ein Client ruft einen Verweis auf eine IMMDeviceEnumerator-Schnittstelle ab, indem die CoCreateInstance-Funktion aufgerufen wird, wie zuvor beschrieben (siehe MMDevice-API).

Die Geräteressourcen, die von den Methoden in der IMMDeviceEnumerator-Schnittstelle aufgezählt werden, werden als Sammlungen von Objekten mit IMMDevice-Schnittstellen dargestellt. Eine Auflistung verfügt über eine IMMDeviceCollection-Schnittstelle . Die IMMDeviceEnumerator::EnumAudioEndpoints-Methode erstellt eine Gerätesammlung.

Um einen Zeiger auf die IMMDevice-Schnittstelle eines Elements in einer Gerätesammlung abzurufen, ruft der Client die IMMDeviceCollection::Item-Methode auf.

Codebeispiele, die die IMMDeviceEnumerator-Schnittstelle verwenden, finden Sie in den folgenden Themen:

• Geräteeigenschaften
• Rendern eines Streams

Vererbung

Die IMMDeviceEnumerator-Schnittstelle erbt von der IUnknown-Schnittstelle . IMMDeviceEnumerator verfügt auch über folgende Membertypen:

Methoden

Die IMMDeviceEnumerator-Schnittstelle verfügt über diese Methoden.

IMMDeviceEnumerator::EnumAudioEndpoints Die EnumAudioEndpoints-Methode generiert eine Sammlung von Audioendpunktgeräten, die die angegebenen Kriterien erfüllen.
IMMDeviceEnumerator::GetDefaultAudioEndpoint Die GetDefaultAudioEndpoint-Methode ruft den Standard-Audioendpunkt für die angegebene Datenflussrichtung und -rolle ab.
IMMDeviceEnumerator::GetDevice Die GetDevice-Methode ruft ein Audioendpunktgerät ab, das durch eine Endpunkt-ID-Zeichenfolge identifiziert wird.
IMMDeviceEnumerator::RegisterEndpointNotificationCallback Die RegisterEndpointNotificationCallback-Methode registriert die Benachrichtigungsrückrufschnittstelle eines Clients.
IMMDeviceEnumerator::UnregisterEndpointNotificationCallback Die UnregisterEndpointNotificationCallback-Methode löscht die Registrierung einer Benachrichtigungsschnittstelle, die der Client in einem vorherigen Aufruf der IMMDeviceEnumerator::RegisterEndpointNotificationCallback-Methode registriert hat.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmdeviceapi.h

Weitere Informationen

Kern-Audioschnittstellen

IMMDevice-Schnittstelle

IMMDeviceCollection-Schnittstelle

IMMDeviceCollection::Item

IMMDeviceEnumerator::EnumAudioEndpoints

MMDevice-API