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:
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
IMMDeviceCollection-Schnittstelle