DIF_NEWDEVICEWIZARD_PRESELECT

Artikel
06/15/2023

Eine DIF_NEWDEVICEWIZARD_PRESELECT Anforderung ermöglicht einem Installationsprogramm das Bereitstellen von Assistentenseiten, die Windows dem Benutzer anzeigt, bevor die Seite select-driver angezeigt wird. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

Sendebedingungen

Nachdem der Benutzer die Klasse für das Gerät ausgewählt hat, aber vor Windows die Seite "Gerätetreiber auswählen" anzeigt.

Wer verarbeitet

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

Installationsprogrammeingabe

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

DeviceInfoData
Stellt einen Zeiger auf eine SP_DEVINFO_DATA-Struktur bereit, die das Gerät im Geräteinformationssatz identifiziert.

Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.

Klasseninstallationsparameter
DeviceInfoData ist eine SP_NEWDEVICEWIZARD_DATA Struktur zugeordnet.

Installationsprogrammausgabe

Geräteinstallationsparameter
Ein Installationsprogramm kann die Flags in den Geräteinstallationsparametern ändern. Windows überprüft die Flags nach Abschluss dieser DIF-Anforderung nicht. Sie überprüft sie jedoch später im Installationsprozess.

Klasseninstallationsparameter
Ein Installationsprogramm kann die SP_NEWDEVICEWIZARD_DATA ändern, um benutzerdefinierte Seiten anzugeben.

Installer-Rückgabewert

Wenn ein Co-Installer diese DIF-Anforderung nicht verarbeitet, gibt es NO_ERROR aus dem Vorverarbeitungsdurchlauf zurück. Wenn ein Co-Installer diese Anforderung verarbeitet, kann es NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED oder einen Win32-Fehlercode zurückgeben.

Ein Klasseninstallationsprogramm gibt NO_ERROR zurück, wenn es erfolgreich Seiten bereitstellt. Andernfalls gibt ein Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT oder einen Win32-Fehlercode zurück.

Standard-DIF-Codehandler

Keine

Installationsprogrammvorgang

Wenn ein Installationsprogramm benutzerdefinierte Vorauswahlseiten hinzufügt, sollte der Installer zuerst überprüfen , ob NumDynamicPages in den Installationsparametern der Klasse MAX_INSTALLWIZARD_DYNAPAGES erreicht hat.

Ein Co-Installer kann benutzerdefinierte Seiten in seinem Vorverarbeitungsdurchlauf und/oder in seinem Nachverarbeitungsdurchlauf hinzufügen. Wenn es Seiten in seinem Vorverarbeitungsdurchlauf hinzufügt, werden diese Seiten vor allen Seiten angezeigt, die vom Klasseninstallationsprogramm bereitgestellt werden.

Wenn ein oder mehrere Installationsprogramme benutzerdefinierte Vorauswahlseiten hinzufügen, zeigt Windows die Seiten vor der Seite "Gerätetreiber auswählen" an. Wenn der Benutzer jedoch auf der Seite "Select-Driver" (Zurück) drückt, überspringt Windows die benutzerdefinierten Vorauswahlseiten und wechselt zur Klassenauswahlseite "Hardwaretyp".

Ein Installationsprogramm sollte einen Wizard 97-Headertitel und einen Headerübertitel in der PROPSHEETPAGE-Struktur für eine benutzerdefinierte Assistentenseite bereitstellen. Ein Installationsprogramm sollte den vom System bereitgestellten Assistententitel nicht ersetzen. Weitere Informationen zu Eigenschaftenseiten finden Sie im Microsoft Windows SDK zur Dokumentation der PROPSHEETPAGE-Struktur.

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