Função KsOpenDefaultDevice (ksproxy.h)

A função KsOpenDefaultDevice abre um identificador para o primeiro dispositivo listado na categoria PnP (Plug and Play) especificada.

Sintaxe

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

Parâmetros

[in] Category

Identificador da categoria PnP a ser enumerada.

[in] Access

Uma máscara de bits ACCESS_MASK especificando como acessar o dispositivo padrão.

[out] DeviceHandle

Ponteiro para uma variável que recebe o identificador para o dispositivo padrão aberto.

Valor de retorno

Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.

Observações

A função KsOpenDefaultDevice passa um ponteiro para categoria em uma chamada para a função SetupDiGetClassDevs para obter um identificador para a lista de dispositivos PnP. Para obter mais informações sobre a máscara de bits ACCESS_MASK e SetupDiGetClassDevs, consulte a documentação do SDK do Microsoft Windows.

Requisitos