Share via

Функция KsOpenDefaultDevice (ksproxy.h)

  • Статья

Функция KsOpenDefaultDevice открывает дескриптор для первого устройства, указанного в указанной категории Plug and Play (PnP).

Синтаксис

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

Параметры

[in] Category

Идентификатор перечисляемой категории PnP.

[in] Access

Битовая маска ACCESS_MASK, указывающая способ доступа к устройству по умолчанию.

[out] DeviceHandle

Указатель на переменную, получающую дескриптор открытого устройства по умолчанию.

Возвращаемое значение

В случае успешного выполнения возвращает значение NOERROR; в противном случае возвращает код ошибки.

Комментарии

Функция KsOpenDefaultDevice передает указатель на Category в вызове функции SetupDiGetClassDevs , чтобы получить дескриптор списка устройств PnP. Дополнительные сведения о ACCESS_MASK битовой маске и SetupDiGetClassDevs см. в документации по Microsoft Windows SDK.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть ksproxy.h (включая Ksproxy.h)
Библиотека Ksproxy.lib