Función KsOpenDefaultDevice (ksproxy.h)

La función KsOpenDefaultDevice abre un identificador para el primer dispositivo que aparece en la categoría Plug and Play (PnP) especificada.

Sintaxis

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

Parámetros

[in] Category

Identificador de la categoría PnP que se va a enumerar.

[in] Access

Máscara de bits ACCESS_MASK que especifica cómo acceder al dispositivo predeterminado.

[out] DeviceHandle

Puntero a una variable que recibe el identificador del dispositivo predeterminado que se abre.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Observaciones

La función KsOpenDefaultDevice pasa un puntero a Category en una llamada a la función SetupDiGetClassDevs para obtener un identificador de la lista de dispositivos PnP. Para obtener más información sobre la máscara de bits de ACCESS_MASK y SetupDiGetClassDevs, consulte la documentación del SDK de Microsoft Windows.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	ksproxy.h (incluya Ksproxy.h)
biblioteca de	Ksproxy.lib