IMDServiceProvider2::CreateDevice-Methode (mswmdm.h)

Die CreateDevice-Methode wird vom Windows Media-Geräte-Manager aufgerufen, um die IMDSPDevice-Objekte abzurufen, die dem kanonischen Gerät entsprechen, das aus dem PnP-Subsystem abgerufen wurde. Diese Methode muss für die Unterstützung von PnP und Windows Explorer implementiert werden, andernfalls ist sie optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Syntax

HRESULT CreateDevice(
  [in]  LPCWSTR     pwszDevicePath,
  [out] DWORD       *pdwCount,
  [out] IMDSPDevice ***pppDeviceArray
);

Parameter

[in] pwszDevicePath

Zeiger auf eine Zeichenfolge mit Breitzeichen mit NULL-Beendigung, die den Gerätepfad des von Windows Media Geräte-Manager erkannten Geräts enthält. Dieser Name wird aus dem PnP-Subsystem abgerufen und ist der kanonische Name plus "$ # ", wobei # eine automatisch inkrementierte Zahl ist. Dieser Name kann direkt an Funktionen wie CreateFile übergeben werden, um Zugriff auf das zugrunde liegende Kernelgeräteobjekt zu erhalten. Der Dienstanbieter sollte ein Wrapper-IMDSPDevice-Objekt (e) für dieses Gerät erstellen.

[out] pdwCount

Zeiger auf ein DWORD , das die Anzahl der erstellten IMDSPDevice-Objekte enthält.

[out] pppDeviceArray

Ein Array von IMDSPDevice-Schnittstellen , die die Geräte darstellen. In der Regel gibt es nur ein Arrayelement, aber ein Dienstanbieter kann mehr als ein IMDSPDevice-Objekt erstellen, das einem Gerätepfadnamen entspricht, wenn er ein IMDSPDevice-Objekt für jeden Speicher auf oberster Ebene erstellt. Dies kann sich in Zukunft ändern, und die Anzahl kann auf 1 beschränkt werden.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn die Methode fehlschlägt, gibt sie die Windows Media-Geräte-Manager Fehlercodes zurück.

Hinweise

Windows Media Geräte-Manager ruft diese Methode auf, wenn eine Anwendung gestartet wird oder wenn ein Plug & Play kompatibles Gerät eine Verbindung mit dem Computer herstellt.

Anforderungen

Weitere Informationen

Auflisten von Geräten

IMDServiceProvider2-Schnittstelle