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)
程式庫 Ksproxy.lib