共用方式為


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 檔案中的 CopyFilesDelfilesRenfiles 專案。

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

規格需求

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

另請參閱

SetupDiCallClassInstaller

SetupDiInstallDevice