共用方式為

KsOpenDefaultDevice 函式 （ksproxy.h）

  • 發行項

KsOpenDefaultDevice 函式會開啟指定隨插即用類別中所列第一個裝置的句柄。

語法

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