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