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 especificada (PnP).

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.

Comentarios

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 ACCESS_MASK y SetupDiGetClassDevs, consulte la documentación de Microsoft Windows SDK.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	ksproxy.h (incluya Ksproxy.h)
Library	Ksproxy.lib