SetupDiInstallDeviceInterfaces 函式 (setupapi.h)

  • 發行項

SetupDiInstallDeviceInterfaces 函式是安裝要求DIF_INSTALLINTERFACES的默認處理程式。

語法

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

參數

[in] DeviceInfoSet

裝置資訊集的指標，其中包含代表要安裝介面之裝置的裝置信息專案。 裝置資訊集只能包含本機系統的元素。

[in] DeviceInfoData

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

傳回值

SetupDiInstallDeviceInterfaces 如果函式完成且沒有錯誤，則會傳回 TRUE 。 如果函式已完成併發生錯誤，則會傳回 FALSE ，而且呼叫 GetLastError 即可擷取失敗的錯誤碼。

備註

SetupDiInstallDeviceInterfaces 會處理 DDInstall 中的每個 AddInterface 專案。裝置 INF 檔案的介面區段，並藉由呼叫 SetupDiCreateDeviceInterface 來建立每個介面。

SetupDiInstallDeviceInterfaces 的呼叫端必須是 Administrators 群組的成員。

注意 只有 類別安裝程式 應該呼叫 SetupDiInstallDeviceInterfaces ，而且只有在類別安裝程式必須在 SetupDiInstallDeviceInterfaces 完成預設裝置介面安裝作業之後，才能執行裝置介面安裝作業。 在這種情況下，當安裝程式處理DIF_INSTALLINTERFACES要求時，類別安裝程序必須直接呼叫 SetupDiInstallDeviceInterfaces 。 如需呼叫預設處理程式的詳細資訊，請參閱呼叫預設 DIF 程式代碼處理程式式。
 
如需 INF 檔格式的相關信息，請參閱 INF 檔案區段和指示詞。

規格需求

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

另請參閱

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface