SetupDiInstallDriverFiles 函式 (setupapi.h)

  • 發行項

SetupDiInstallDriverFiles 函式是安裝要求DIF_INSTALLDEVICEFILES的默認處理程式。

語法

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

參數

[in] DeviceInfoSet

裝置資訊集的句柄，其中包含代表要安裝檔案之裝置的裝置信息元素。 裝置資訊集不得包含遠端元素。

[in] DeviceInfoData

指定 DeviceInfoSet 中裝置資訊元素之SP_DEVINFO_DATA結構的指標。

傳回值

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

備註

如果使用此函式來安裝檔案， SetupDiInstallDriverFiles 的呼叫端必須是 Administrators 群組的成員。 不過，如果使用此函式來建置檔案佇列，則不需要 Administrators 群組中的成員資格。

注意 只有類別安裝程式應該呼叫 SetupDiInstallDriverFiles ，而且只有在類別安裝程式必須在 SetupDiInstallDriverFiles 完成預設驅動程式檔案安裝作業之後，才執行驅動程式檔案安裝作業。 在這種情況下，當安裝程式處理DIF_INSTALLDEVICEFILES要求時，類別安裝程序必須直接呼叫 SetupDiInstallDriverFiles 。 如需呼叫預設處理程式的詳細資訊，請參閱呼叫預設 DIF 程式代碼處理程式式。
 
SetupDiInstallDriverFiles 的作業類似於 SetupDiInstallDevice 函式。 不過，此函式只會執行 SetupDiInstallDevice 所執行的檔案複製作業。

呼叫此函式之前，必須先針對指定的裝置資訊集或元素選取驅動程式。

此函式會處理所選 INF 檔案中的 CopyFiles、 Delfiles 和 Renfiles 專案。

DeviceInfoSet 只能包含本機計算機上的元素。

規格需求

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

另請參閱

SetupDiCallClassInstaller

SetupDiInstallDevice