SetupDiSelectOEMDrv 函式 (setupapi.h)
SetupDiSelectOEMDrv函式會為裝置資訊集或使用使用者提供的 OEM 路徑的特定裝置資訊元素選取驅動程式。
語法
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
參數
[in, optional] hwndParent
視窗控制碼,將會是處理此函式期間所建立之任何對話方塊的父代。 此參數可用來覆寫指定裝置資訊集或元素之安裝參數區塊中的 hwndParent 欄位。
[in] DeviceInfoSet
要為其選取驅動程式之 裝置資訊集 的控制碼。
[in, out] DeviceInfoData
SP_DEVINFO_DATA結構的指標,指定DeviceInfoSet中的裝置資訊專案。 這個參數是選擇性的,而且可以是 Null。 如果指定此參數, SetupDiSelectOEMDrv 會將選取的驅動程式與指定的裝置產生關聯。 如果此參數為 Null, SetupDiSelectOEMDrv 會將選取的驅動程式與 DeviceInfoSet的全域類別驅動程式清單產生關聯。
傳回值
如果函式成功,函式會傳回 TRUE 。 否則,它會傳回 FALSE ,而且可以透過 呼叫 GetLastError來擷取記錄的錯誤。
備註
SetupDiSelectOEMDrv 主要是設計為在本機電腦上選取裝置的 OEM 驅動程式,然後再在該電腦上安裝裝置。 雖然 SetupDiSelectOEMDrv 不會因為裝置資訊集是針對遠端電腦而失敗,但結果會受到限制,因為裝置資訊集之後無法與遠端電腦上的DIF_Xxx 安裝要求或 SetupDiXxx 函式搭配使用。 特別是,裝置資訊集無法當做輸入與DIF_INSTALLDEVICE安裝要求搭配使用,以在遠端電腦上安裝裝置。
SetupDiSelectOEMDrv 會提示使用者輸入 OEM 路徑,然後呼叫類別安裝程式,從 OEM 路徑選取驅動程式。
需求
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌上型 |
標頭 | setupapi.h (包括 Setupapi.h) |
程式庫 | Setupapi.lib |
Dll | Setupapi.dll |