Funzione KsOpenDefaultDevice (ksproxy.h)

La funzione KsOpenDefaultDevice apre un handle al primo dispositivo elencato nella categoria di Plug and Play (PnP) specificata.

Sintassi

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

Parametri

[in] Category

Identificatore della categoria PnP da enumerare.

[in] Access

Maschera di bit ACCESS_MASK che specifica come accedere al dispositivo predefinito.

[out] DeviceHandle

Puntatore a una variabile che riceve l'handle per il dispositivo predefinito aperto.

Valore restituito

Restituisce NOERROR se l'operazione riesce; in caso contrario, restituisce un codice di errore.

Commenti

La funzione KsOpenDefaultDevice passa un puntatore a Category in una chiamata alla funzione SetupDiGetClassDevs per ottenere un handle all'elenco di dispositivi PnP. Per altre informazioni sulla maschera di bit ACCESS_MASK e SetupDiGetClassDevs, vedere la documentazione di Microsoft Windows SDK.

Requisiti