DIF_REGISTER_COINSTALLERS
DIF_REGISTER_COINSTALLERS要求可讓安裝程式參與裝置共同安裝程式的註冊。
傳送時
完成裝置安裝之前。
誰處理
類別共同安裝程式 |
可以處理 |
裝置共同安裝程式 |
不處理 |
類別安裝程式 |
可以處理 |
安裝程式輸入
DeviceInfoSet
提供裝置 資訊的 控制碼，其中包含要註冊共同安裝程式的裝置。
DeviceInfoData
提供 SP_DEVINFO_DATA結構的指標 ，以識別裝置資訊集中的裝置。
裝置安裝參數
與DeviceInfoData相關聯的裝置安裝參數 (SP_DEVINSTALL_PARAMS) 。
安裝程式輸出
安裝程式傳回值
共同安裝程式可以傳回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 錯誤碼。
如果類別安裝程式成功處理此要求， 且 SetupDiCallClassInstaller 後續應該呼叫預設處理常式，類別安裝程式會傳回ERROR_DI_DO_DEFAULT。
如果類別安裝程式成功處理此要求，包括直接呼叫預設處理常式，類別安裝程式應該會傳回NO_ERROR， 而 SetupDiCallClassInstaller 不會接著再次呼叫預設處理常式。
注意 類別安裝程式可以直接呼叫預設處理常式，但類別安裝程式不應嘗試取代預設處理常式的作業。
如需呼叫預設處理常式的詳細資訊，請參閱 呼叫預設 DIF 程式碼處理常式。
如果類別安裝程式發生錯誤，安裝程式應該會傳回適當的 Win32 錯誤碼， 而且 SetupDiCallClassInstaller 後續不會呼叫預設處理常式。
預設 DIF 程式碼處理常式
SetupDiRegisterCoDeviceInstallers
安裝程式作業
為了回應DIF_REGISTER_COINSTALLERS要求，安裝程式可能會修改裝置的共同安裝程式清單。 例如，安裝程式可能會以程式設計方式註冊或移除以裝置分析為基礎的裝置特定共同安裝程式。
除非設定DI_NOFILECOPY旗標，否則處理此 DIF 要求的安裝程式應該複製共同安裝程式 () 所需的檔案。
如果DI_NOFILECOPY旗標清楚，但已設定DI_NOVCP旗標，安裝程式必須將任何檔案作業加入提供的檔案佇列，但不得認可佇列。
如果安裝程式傳回 Win32 錯誤碼，Windows 會停止安裝。
如需 DIF 程式碼的詳細資訊，請參閱 處理 DIF 程式碼。
規格需求
版本 |
Microsoft Windows 2000 和更新版本的 Windows 支援。 |
標頭 |
Setupapi.h (包含 Setupapi.h) |