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

Weitere Informationen

IMDSPDevice-Schnittstelle

IMDSPEnumDevice-Schnittstelle