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 程式代碼處理程式式。
呼叫此函式之前，必須先針對指定的裝置資訊集或元素選取驅動程式。
此函式會處理所選 INF 檔案中的 CopyFiles、 Delfiles 和 Renfiles 專案。
DeviceInfoSet 只能包含本機計算機上的元素。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |