IMDServiceProvider::EnumDevices-Methode (mswmdm.h)
Die EnumDevices-Methode listet die installierten physischen oder Softwaregeräte auf, die derzeit angefügt sind und dem Dienstanbieter bekannt sind.
Syntax
HRESULT EnumDevices(
[out] IMDSPEnumDevice **ppEnumDevice
);
Parameter
[out] ppEnumDevice
Zeiger auf eine IMDSPEnumDevice-Schnittstelle . Wenn der Dienstanbieter IMDServiceProvider2::CreateDevice implementiert, sollte dieser Enumerator nur nicht Plug & Play Geräte aufzählen.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Diese Methode wird für Dienstanbieter aufgerufen, die nicht als Plug & Play-fähig registriert sind (weitere Informationen finden Sie unter Aktivieren von PnP für Geräte und Auflisten von Geräten). Ein Dienstanbieter sollte nur den Enumerator zurückgeben, der nur die Geräte aufzählt, die derzeit an den Computer angefügt sind und vom Dienstanbieter unterstützt werden.
Diese Methode wird nur aufgerufen, wenn eine Anwendung gestartet wird oder wenn die Anwendung IWMDeviceManager2::Reinitialize aufruft.
Derzeit unterstützt Windows Media Geräte-Manager die Rückgabe installierter Geräte nicht.
Der Dienstanbieter kann die Anwendung nicht benachrichtigen, wenn Geräte eine Verbindung mit dem Computer herstellen oder trennen. Wenn ein Plug & Play Gerät eine Verbindung herstellt oder trennt und eine Anwendung IWMDMNotification implementiert, sendet Windows Media Geräte-Manager eine Benachrichtigung an die Anwendung.
Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |