KsOpenDefaultDefaultDevice-Funktion (ksproxy.h)

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

Syntax

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

Parameter

[in] Category

Bezeichner der zu enumerierenden PnP-Kategorie.

[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 war. Gibt andernfalls 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 abzurufen. Weitere Informationen zur ACCESS_MASK Bitmaske und SetupDiGetClassDevs finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen