DIF_NEWDEVICEWIZARD_POSTANALYZE

Artikel
06/14/2023

Eine DIF_NEWDEVICEWIZARD_POSTANALYZE-Anforderung ermöglicht es einem Installationsprogramm, Assistentenseiten bereitzustellen, die Windows dem Benutzer anzeigt, nachdem der Geräteknoten (Devnode) registriert wurde, aber bevor Windows die Treiber für das Gerät installiert. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

Sendebedingungen

Nachdem Windows das Gerät registriert hat, wodurch der Devnode "live" wird, aber bevor Windows die Treiber für das Gerät installiert.

Wer behandelt

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

Eingabe des Installationsprogramms

DeviceInfoSet
Stellt ein Handle für den Geräteinformationssatz bereit , der das Gerät enthält.

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. Diese werden jedoch später während des Installationsvorgangs überprüft.

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

Rückgabewert des Installers

Wenn ein Co-Installer diese DIF-Anforderung nicht verarbeitet, gibt es NO_ERROR aus seinem 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

Installer-Vorgang

Eine DIF_NEWDEVICEWIZARD_POSTANALYZE-Anforderung ermöglicht es einem Installationsprogramm, Assistentenseiten bereitzustellen, die Windows dem Benutzer anzeigt, nachdem der Devnode registriert wurde, aber bevor Windows die Treiber für das Gerät installiert. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

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

Nachdem der Benutzer auf einer benutzerdefinierten Seite auf Weiter geklickt hat, installiert Windows die Treiber für das Gerät, und der PnP-Manager startet das Gerät. Eine Seite des Assistenten nach der Analyse ist die letzte Gelegenheit für ein Installationsprogramm, die Arbeit zu erledigen, bevor die Treiber geladen und das Gerät gestartet wird.

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

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