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) |