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

Статья
02/07/2025

Функция 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 передает указатель на категории в вызове функции setupDiGetClassDevs, чтобы получить дескриптор списка устройств PnP. Дополнительные сведения о битовой маске ACCESS_MASK и SetupDiGetClassDevsсм. в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	ksproxy.h (включая Ksproxy.h)
библиотеки	Ksproxy.lib

Поделиться через