DIF_NEWDEVICEWIZARD_PREANALYZE

Artikel
06/15/2023

Eine DIF_NEWDEVICEWIZARD_PREANALYZE-Anforderung ermöglicht es einem Installationsprogramm, Assistentenseiten bereitzustellen, die Windows dem Benutzer anzeigt, bevor die Analyseseite angezeigt wird. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

Sendebedingungen

Nachdem der Benutzer einen Treiber ausgewählt hat, aber bevor Windows das Gerät registriert, das den Geräteknoten (Devnode) "live" macht.

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. Sie überprüft sie jedoch später im Installationsvorgang.

Klasseninstallationsparameter
Ein Installationsprogramm kann die SP_NEWDEVICEWIZARD_DATA ändern, um benutzerdefinierte Assistentenseiten 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_PREANALYZE-Anforderung ermöglicht es einem Installationsprogramm, Assistentenseiten bereitzustellen, die Windows dem Benutzer anzeigt, bevor die Analyseseite angezeigt wird. Diese Seiten können als "Postselect"-Seiten betrachtet werden. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

Ein Installationsprogramm kann eine benutzerdefinierte Vorabanalyseseite verwenden, um beispielsweise einen COM-Port auszuwählen, nachdem ein Modemgerät ausgewählt wurde.

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

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.