KsOpenDefaultDevice-Funktion (ksproxy.h)

The KsOpenDefaultDevice function opens a handle to the first device that is listed in the specified Plug and Play (PnP) category.

Syntax

KSDDKAPI HRESULT KsOpenDefaultDevice(
  [in]  REFGUID     Category,
  [in]  ACCESS_MASK Access,
  [out] PHANDLE     DeviceHandle
);

Parameter

[in] Category

Bezeichner der zu aufzählenden PnP-Kategorie.

[in] Access

Eine ACCESS_MASK Bitmaske, die den Zugriff auf das Standardgerät ankn.)

[out] DeviceHandle

Zeiger auf eine Variable, die das Handle auf das geöffnete Standardgerät empfängt.

Rückgabewert

Gibt NOERROR zurück, wenn erfolgreich; andernfalls gibt einen Fehlercode zurück.

Hinweise

Die KsOpenDefaultDevice-Funktion übergibt einen Zeiger auf Category in einem Aufruf der SetupDiGetClassDevs-Funktion , um ein Handle für die Liste der PnP-Geräte zu erhalten. Weitere Informationen zur Bitmaske ACCESS_MASK SetupDiGetClassDevs finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen

   
Zielplattform Desktop
Kopfzeile ksproxy.h (einschließlich Ksproxy.h)
Bibliothek Ksproxy.lib