DIF_INSTALLINTERFACES

DIF_INSTALLINTERFACES要求可讓安裝程式參與裝置的裝置介面註冊。

傳送時

註冊裝置共同安裝程式之後,但在完成裝置安裝之前。

誰處理

類別共同安裝程式

可以處理

裝置共同安裝程式

可以處理

類別安裝程式

可以處理

安裝程式輸入

DeviceInfoSet
提供包含 裝置之裝置資訊集 的控制碼。

DeviceInfoData
提供 SP_DEVINFO_DATA 結構的指標,以識別裝置資訊集中的裝置。

裝置安裝參數
DeviceInfoData相關聯的裝置安裝參數 (SP_DEVINSTALL_PARAMS)

類別安裝參數

安裝程式輸出

裝置安裝參數
安裝程式可能會修改裝置安裝參數,但通常不適用於此 DIF 要求。

安裝程式傳回值

共同安裝程式可以傳回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 錯誤碼。

如果類別安裝程式成功處理此要求, 而且 SetupDiCallClassInstaller 後續應該呼叫預設處理常式,則類別安裝程式會傳回ERROR_DI_DO_DEFAULT。

如果類別安裝程式成功處理此要求,包括直接呼叫預設處理常式,類別安裝程式應該會傳回NO_ERROR, 而 SetupDiCallClassInstaller 後續不會再次呼叫預設處理常式。

注意 類別安裝程式可以直接呼叫預設處理常式,但類別安裝程式不應該嘗試取代預設處理常式的作業。

如需呼叫預設處理常式的詳細資訊,請參閱 呼叫預設 DIF 程式碼處理常式

如果類別安裝程式發生錯誤,安裝程式應該會傳回適當的 Win32 錯誤碼,而且 SetupDiCallClassInstaller 後續不會呼叫預設處理常式。

預設 DIF 程式碼處理常式

SetupDiInstallDeviceInterfaces

安裝程式作業

為了回應DIF_INSTALLINTERFACES要求安裝程式可能會以程式設計方式註冊裝置介面,而不是透過 INF 檔案註冊介面。 一般而言,廠商提供的安裝程式不會處理此 DIF 要求。

除非設定DI_NOFILECOPY旗標,否則處理此 DIF 要求的安裝程式應該複製裝置介面 () 所需的檔案。

如果DI_NOFILECOPY旗標清楚,但已設定DI_NOVCP旗標,安裝程式必須將任何檔案作業加入至提供的檔案佇列,但不得認可佇列。

例如,如果安裝程式註冊裝置介面,則裝置的核心模式元件 (例如,驅動程式) 必須呼叫 IoSetDeviceInterfaceState 才能啟用介面。

如果安裝程式傳回 Win32 錯誤碼,Windows 會停止安裝。

如需 DIF 程式碼的詳細資訊,請參閱 處理 DIF 程式碼

規格需求

版本

Microsoft Windows 2000 和更新版本的 Windows 支援。

標頭

Setupapi.h (包括 Setupapi.h)

另請參閱

SetupDiInstallDeviceInterfaces

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS