SetupDiGetSelectedDevice 函式 (setupapi.h)

SetupDiGetSelectedDevice 函式會擷取裝置資訊集中選取的裝置資訊元素。

語法

WINSETUPAPI BOOL SetupDiGetSelectedDevice(
  [in]  HDEVINFO         DeviceInfoSet,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

參數

[in] DeviceInfoSet

要擷取所選 裝置資訊項目的裝置資訊集 句柄。

[out] DeviceInfoData

SP_DEVINFO_DATA 結構的指標,可接收DeviceInfoSet所選取裝置資訊專案的相關信息。 呼叫端必須設定 DeviceInfoData。cbSize 為 sizeof (SP_DEVINFO_DATA) 。 如果目前未選取裝置,函式會失敗,而且 GetLastError 的呼叫會傳回ERROR_NO_DEVICE_SELECTED。

傳回值

如果函式成功,函式會傳回 TRUE 。 否則,它會傳回 FALSE ,而且可以使用 呼叫 GetLastError 來擷取記錄的錯誤。

備註

SetupDiGetSelectedDevice 通常是由安裝精靈使用。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

SP_DEVINFO_DATA

SetupDiSetSelectedDevice