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 檔。

規格需求