共用方式為


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 會將選取的驅動程式與指定的裝置產生關聯。 如果此參數為 NullSetupDiSelectOEMDrv 會將選取的驅動程式與 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

另請參閱

SetupDiAskForOEMDisk