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 文档。

要求