KsOpenDefaultDevice-Funktion (ksproxy.h)

Die KsOpenDefaultDevice--Funktion öffnet ein Handle für das erste Gerät, das in der angegebenen Plug and Play-Kategorie (PnP) aufgeführt ist.

Syntax

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

Parameter

[in] Category

Bezeichner der PnP-Kategorie, die aufgezählt werden soll.

[in] Access

Eine ACCESS_MASK Bitmaske, die angibt, wie auf das Standardgerät zugegriffen werden soll.

[out] DeviceHandle

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

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

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

Anforderungen