DIF_NEWDEVICEWIZARD_PREANALYZE
DIF_NEWDEVICEWIZARD_PREANALYZE要求可讓安裝程式提供 Windows 在顯示分析頁面之前向使用者顯示的精靈頁面。 此要求只會在手動安裝非 PnP 裝置期間使用。
傳送時
使用者選取驅動程式之後，但在 Windows 註冊裝置之前，裝置節點 (devnode) 「即時」。
誰處理
類別共同安裝程式 |
可以處理 |
裝置共同安裝程式 |
不處理 |
類別安裝程式 |
可以處理 |
安裝程式輸入
DeviceInfoSet
提供包含裝置之 裝置資訊集 的控制碼。
DeviceInfoData
提供 SP_DEVINFO_DATA結構的指標 ，以識別裝置資訊集中的裝置。
裝置安裝參數
與DeviceInfoData相關聯的裝置安裝參數 (SP_DEVINSTALL_PARAMS) 。
類別安裝參數
SP_NEWDEVICEWIZARD_DATA結構與DeviceInfoData相關聯。
安裝程式輸出
裝置安裝參數
安裝程式可以修改裝置安裝參數中的旗標。 Windows 不會在此 DIF 要求完成時檢查旗標。 不過，稍後會在安裝程式中檢查它們。
類別安裝參數
安裝程式可以修改 SP_NEWDEVICEWIZARD_DATA ，以提供自訂精靈頁面 (s) 。
安裝程式傳回值
如果共同安裝程式未處理此 DIF 要求，它會從前置處理階段傳回NO_ERROR。 如果共同安裝程式處理此要求，它可以傳回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 錯誤碼。
如果類別安裝程式成功提供頁面 () ，則類別安裝程式會傳回NO_ERROR。 否則，類別安裝程式會傳回ERROR_DI_DO_DEFAULT或 Win32 錯誤碼。
預設 DIF 程式碼處理常式
無
安裝程式作業
DIF_NEWDEVICEWIZARD_PREANALYZE要求可讓安裝程式提供 Windows 在顯示分析頁面之前向使用者顯示的精靈頁面。 這些頁面可以視為「後置選取」頁面。 此要求只會在手動安裝非 PnP 裝置期間使用。
例如，安裝程式可能會使用自訂預先分析頁面，在選取數據機裝置之後選擇 COM 埠。
如果安裝程式新增自訂預先選取頁面 (s) ，安裝程式應該先檢查類別安裝參數中的 NumDynamicPages 是否已達到MAX_INSTALLWIZARD_DYNAPAGES。
安裝程式應該會在自訂精靈頁面的 PROPSHEETPAGE 結構中提供精靈 97 標頭標題和標頭子標題。 安裝程式不應取代系統提供的精靈標題。 如需 PROPSHEETPAGE 結構的檔以及屬性頁的詳細資訊，請參閱Microsoft Windows SDK。
如需 DIF 程式碼的詳細資訊，請參閱 處理 DIF 程式碼。
規格需求
版本 |
Microsoft Windows 2000 和更新版本的 Windows 支援。 |
標頭 |
Setupapi.h (包含 Setupapi.h) |