IMDSPEnumDevice::Next-Methode (mswmdm.h)
Die Next-Methode ruft einen Zeiger auf die nächste celtIMDSPDevice-Schnittstelle ab.
Syntax
HRESULT Next(
[in] ULONG celt,
[out] IMDSPDevice **ppDevice,
[out] ULONG *pceltFetched
);
Parameter
[in] celt
Anzahl der angeforderten Geräte.
[out] ppDevice
Array von Celt-ZeigernIMDSPDevice, die vom Aufrufer zugeordnet werden. Geben Sie NULL zurück, um anzugeben, dass keine geräte mehr vorhanden sind oder ein Fehler aufgetreten ist. Wenn celt mehr als 1 ist, muss der Aufrufer genügend Arbeitsspeicher zuweisen, um die Anzahl der Schnittstellenzeiger zu speichern.
[out] pceltFetched
Zeiger auf eine ULONG-Variable , die die Anzahl der abgerufenen Schnittstellen empfängt.
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
Wenn keine Dienstanbieterschnittstellen für enumerierte Geräte vorhanden sind oder weniger dieser Schnittstellen vorhanden sind als vom celt-Parameter angefordert, ist der Rückgabewert von Next S_FALSE. In diesem Fall muss der parameter pceltFetched abgefragt werden, um zu bestimmen, wie viele Schnittstellen (falls vorhanden) zurückgegeben wurden.
Der Geräteenumerator spiegelt möglicherweise nicht die Auswirkungen des Ein- und Entfernens von Geräten wider.
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 |