DIF_ADDPROPERTYPAGE_ADVANCED

Eine DIF_ADDPROPERTYPAGE_ADVANCED-Anforderung ermöglicht es einem Installationsprogramm, eine oder mehrere benutzerdefinierte Eigenschaftenseiten für ein Gerät anzugeben.

Sendebedingungen

Wenn ein Benutzer auf die Eigenschaften für ein Gerät in Geräte-Manager oder in Systemsteuerung klickt.

Wer verarbeitet

Klassen-Co-Installer	Kann verarbeiten
Geräte-Co-Installer	Kann verarbeiten
Klasseninstallationsprogramm	Kann verarbeiten

Installationsprogrammeingabe

DeviceInfoSet
Stellt dem Geräteinformationssatz , der das Gerät enthält, ein Handle bereit.

DeviceInfoData
Stellt optional einen Zeiger auf eine SP_DEVINFO_DATA-Struktur bereit, die das Gerät im Geräteinformationssatz identifiziert. Wenn DeviceInfoSetNULL ist, fordert Windows Eigenschaftenseiten für die Geräteeinrichtungsklasse an.

Geräteinstallationsparameter
Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) sind der DeviceInfoData(sofern angegeben) oder dem DeviceInfoSet zugeordnet.

Klasseninstallationsparameter
Eine SP_ADDPROPERTYPAGE_DATA-Struktur ist dem DeviceInfoData(sofern angegeben) oder dem DeviceInfoSet zugeordnet.

Installationsprogrammausgabe

Geräteinstallationsparameter
Ein Installationsprogramm kann die Geräteinstallationsparameter ändern.

Klasseninstallationsparameter
Ein Installationsprogramm kann die SP_ADDPROPERTYPAGE_DATA so ändern, dass benutzerdefinierte Seiten bereitgestellt werden.

Installer-Rückgabewert

Ein Co-Installer kann NO_ERROR oder einen Win32-Fehler zurückgeben. Ein Co-Installer sollte nicht ERROR_DI_POSTPROCESSING_REQUIRED für diese DIF-Anforderung zurückgeben.

Ein Klasseninstallationsprogramm gibt NO_ERROR zurück, wenn seiten erfolgreich bereitgestellt werden. Andernfalls gibt ein Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT oder einen Win32-Fehlercode zurück.

Standard-DIF-Codehandler

Keine

Installationsprogrammvorgang

Als Antwort auf diese DIF-Anforderung kann ein Installationsprogramm benutzerdefinierte Eigenschaftenseiten bereitstellen. Mit dieser DIF-Anforderung können Sie Eigenschaftenseiten aus einem Klasseninstallationsprogramm oder Co-Installer bereitstellen und entfällt die Notwendigkeit einer separaten DLL, die als Eigenschaftenseitenanbieter fungiert.

Ein Installer verarbeitet in der Regel diese DIF-Anforderung, um eine neue gerätespezifische oder setupklassenspezifische Eigenschaftenseite hinzuzufügen. Ein Installationsprogramm kann auch die vom System bereitgestellte Treibereigenschaftenseite, Ressourceneigenschaftenseite oder Energieeigenschaftenseite für ein Gerät ersetzen. Wenn ein Installationsprogramm eine vom System bereitgestellte Seite ersetzt, muss das Installationsprogramm das entsprechende Flag in den Geräteinstallationsparametern für das Gerät festlegen:

DI_DRIVERPAGE_ADDED
Das Installationsprogramm hat eine Treibereigenschaftenseite bereitgestellt.

DI_RESOURCEPAGE_ADDED
Das Installationsprogramm hat eine Ressourceneigenschaftenseite bereitgestellt.

DI_FLAGSEX_POWERPAGE_ADDED
Das Installationsprogramm hat eine Energieeigenschaftenseite bereitgestellt.

Ein Installationsprogramm kann die vom System bereitgestellte allgemeine Eigenschaftenseite nicht ersetzen.

Windows zeigt nur eine Treiberseite, eine Ressourcenseite und eine Energieseite für ein Gerät an. Ein Installationsprogramm sollte keine Ersatzsystemseite bereitstellen, wenn ein vorheriges Installationsprogramm bereits eine Seite dieses Typs bereitgestellt hat. Diese Einschränkung gilt nicht für nicht vom System bereitgestellte Eigenschaftenseiten.

Ein Co-Installer sollte in seinem Vorverarbeitungsdurchlauf benutzerdefinierte Seiten hinzufügen.

Wenn ein Installationsprogramm es einem Benutzer ermöglicht, eine Eigenschaft festzulegen, für die Windows das Gerät entfernen und neu starten muss, muss das Installationsprogramm das flag DI_FLAGSEX_PROPCHANGE_PENDING in den Geräteinstallationsparametern aus seiner DialogProc-Routine festlegen.

Weitere Informationen zum Bereitstellen von Geräteeigenschaftenseiten finden Sie unter Bereitstellen von Geräteeigenschaftenseiten.

Weitere Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes.

Requirements (Anforderungen)

Version	Unterstützt in Microsoft Windows 2000 und höheren Versionen von Windows.
Header	Setupapi.h (einschließlich Setupapi.h)

Weitere Informationen

SP_ADDPROPERTYPAGE_DATA

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS