DIF_ADDPROPERTYPAGE_ADVANCED
DIF_ADDPROPERTYPAGE_ADVANCED要求可讓安裝程式提供裝置的一或多個自訂屬性頁。
傳送時
當使用者在 裝置管理員 或 主控台 中按一下裝置的屬性時。
誰處理
類別共同安裝程式 |
可以處理 |
裝置共同安裝程式 |
可以處理 |
類別安裝程式 |
可以處理 |
安裝程式輸入
DeviceInfoSet
提供包含裝置之 裝置資訊集 的控制碼。
DeviceInfoData
選擇性地提供 SP_DEVINFO_DATA 結構的指標，以識別裝置資訊集中的裝置。 如果 DeviceInfoSet 為 Null，Windows 會要求 裝置安裝類別的屬性頁。
裝置安裝參數
如果指定或DeviceInfoSet， (SP_DEVINSTALL_PARAMS) 裝置安裝參數會與DeviceInfoData相關聯。
類別安裝參數
如果指定或DeviceInfoSet，SP_ADDPROPERTYPAGE_DATA結構會與DeviceInfoData相關聯。
安裝程式輸出
類別安裝參數
安裝程式可以修改 SP_ADDPROPERTYPAGE_DATA 以提供自訂頁面。
安裝程式傳回值
共同安裝程式可以傳回NO_ERROR或 Win32 錯誤。 共同安裝程式不應該傳回此 DIF 要求的ERROR_DI_POSTPROCESSING_REQUIRED。
如果類別安裝程式成功提供頁面，則會傳回NO_ERROR。 否則，類別安裝程式會傳回ERROR_DI_DO_DEFAULT或 Win32 錯誤碼。
預設 DIF 程式碼處理常式
無
安裝程式作業
為了回應此 DIF 要求，安裝程式可以提供自訂屬性頁。 處理此 DIF 要求可讓您從類別安裝程式或共同安裝程式提供屬性頁，並移除作為屬性頁提供者的個別 DLL 需求。
安裝程式通常會處理此 DIF 要求，以新增裝置特定或安裝程式類別特定的屬性頁。 安裝程式也可以取代裝置的系統提供的驅動程式屬性頁、資源屬性頁或電源屬性頁。 如果安裝程式取代系統提供的頁面，安裝程式必須在裝置的裝置安裝參數中設定適當的旗標：
DI_DRIVERPAGE_ADDED
安裝程式提供驅動程式屬性頁。
DI_RESOURCEPAGE_ADDED
安裝程式提供了資源屬性頁。
DI_FLAGSEX_POWERPAGE_ADDED
安裝程式提供電源屬性頁。
安裝程式無法取代系統提供的一般屬性頁面。
Windows 只會顯示一個驅動程式頁面、一個資源頁面，以及一個裝置的電源頁面。 如果先前的安裝程式已經提供該類型的頁面，安裝程式就不應該提供取代系統頁面。 此條件約束不適用於非系統提供的屬性頁。
共同安裝程式應該在其前置處理階段中新增自訂頁面。
如果安裝程式允許使用者設定需要 Windows 移除並重新啟動裝置的屬性，安裝程式必須在其 DialogProc 常式的裝置安裝參數中設定DI_FLAGSEX_PROPCHANGE_PENDING旗標。
如需如何提供裝置屬性頁的詳細資訊，請參閱 提供裝置屬性頁。
如需 DIF 程式碼的詳細資訊，請參閱 處理 DIF 程式碼。
規格需求
版本 |
Microsoft Windows 2000 和更新版本的 Windows 支援。 |
標頭 |
Setupapi.h (包含 Setupapi.h) |