KsOpenDefaultDevice 函数 (ksproxy.h)

  • 项目

KsOpenDefaultDevice 函数打开指定即插即用 (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 函数时传递指向 Category 的指针，以获取 PnP 设备列表的句柄。 有关 ACCESS_MASK 位掩码和 SetupDiGetClassDevs 的详细信息，请参阅 Microsoft Windows SDK 文档。

要求

要求 值
目标平台 桌面
标头 ksproxy.h (包括 Ksproxy.h)
Library Ksproxy.lib