DIF_NEWDEVICEWIZARD_SELECT
DIF_NEWDEVICEWIZARD_SELECT要求可讓安裝程式提供自訂精靈頁面 () ,以取代標準選取驅動程式頁面。 此要求只會在手動安裝非 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_SELECT要求可讓安裝程式提供自訂精靈頁面 () ,以取代標準選取驅動程式頁面。 此要求只會在手動安裝非 PnP 裝置期間使用。
安裝程式會回應此 DIF 要求,以完全取代標準選取驅動程式精靈頁面。 相反地,如果安裝程式只需要修改標準頁面或修改要從中選擇的驅動程式清單,安裝程式應該這麼做以回應 DIF_SELECTDEVICE 要求。
共同安裝程式應該在其後置處理階段中新增自訂頁面 () ,而且只有在類別安裝程式未 () 新增自訂頁面時。 如果類別安裝程式已新增頁面 () ,則不應該使用共同安裝程式。 否則,系統可能會要求使用者選擇驅動程式兩次。
如果安裝程式提供自訂選取頁面,安裝程式必須設定選取的驅動程式。 在支援精靈頁面的安裝程式程式碼中,使用者按一下 [ 下一步] 之後,安裝程式必須呼叫 SetupDiSetSelectedDriver。
安裝程式應該在自訂精靈頁面的 PROPSHEETPAGE 結構中提供精靈 97 標頭標題和標頭子標題。 安裝程式不應該取代系統提供的精靈標題。 如需 PROPSHEETPAGE 結構的檔以及屬性頁的詳細資訊,請參閱Microsoft Windows SDK。
如需 DIF 程式碼的詳細資訊,請參閱 處理 DIF 程式碼。
規格需求
版本 |
Microsoft Windows 2000 和更新版本的 Windows 支援。 |
標頭 |
Setupapi.h (包括 Setupapi.h) |
另請參閱
DIF_NEWDEVICEWIZARD_PREANALYZE