DIF_UNREMOVE

DIF_UNREMOVE要求通知安裝程式 Windows 即將在指定的硬體設定檔中恢復裝置,並讓安裝程式有機會參與作業。 Windows 只會針對非 PnP 裝置傳送此要求。

傳送時

當根列舉時,非 PnP 裝置會恢復為硬體設定檔。

誰處理

類別共同安裝程式

可以處理

裝置共同安裝程式

可以處理

類別安裝程式

可以處理

安裝程式輸入

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

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

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

類別安裝參數
SP_UNREMOVEDEVICE_PARAMS結構與DeviceInfoData相關聯。 [ 範圍 ] 欄位必須設定為 [DI_UNREMOVEDEVICE_CONFIGSPECIFIC],且必須在 [HwProfile ] 欄位中指定硬體設定檔。

安裝程式輸出

安裝程式傳回值

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

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

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

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

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

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

預設 DIF 程式碼處理常式

SetupDiUnremoveDevice

安裝程式作業

「取消移除」裝置基本上表示 Windows 會清除先前在特定硬體設定檔中將裝置標示為「不存在」的旗標。

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

規格需求

版本

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

標頭

Setupapi.h (包含 Setupapi.h)

另請參閱

SetupDiUnremoveDevice

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_UNREMOVEDEVICE_PARAMS