DIF_NEWDEVICEWIZARD_SELECT

Artikel
06/15/2023

Eine DIF_NEWDEVICEWIZARD_SELECT Anforderung ermöglicht es einem Installationsprogramm, benutzerdefinierte Assistentenseiten zur Verfügung zu stellen, die die Standardauswahltreiberseite ersetzen. Diese Anforderung wird nur während der manuellen Installation von Nicht-PnP-Geräten verwendet.

Sendebedingungen

Unmittelbar vor windows wird die Seite "Gerätetreiber auswählen" angezeigt.

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

Ein Installationsprogramm reagiert auf diese DIF-Anforderung, um die Standardseite des Assistenten zum Auswählen des Treibers vollständig zu ersetzen. Wenn das Installationsprogramm stattdessen nur die Standardseite ändern oder die Liste der Treiber ändern muss, aus denen ausgewählt werden soll, sollte das Installationsprogramm dies als Reaktion auf die DIF_SELECTDEVICE Anforderung tun.

Ein Co-Installer sollte benutzerdefinierte Seiten in seinem Nachverarbeitungsdurchlauf hinzufügen, und das nur, wenn das Klasseninstallationsprogramm keine benutzerdefinierten Seiten hinzugefügt hat. Wenn das Klasseninstallationsprogramm Seiten hinzugefügt hat, sollte der Co-Installer dies nicht. Andernfalls wird der Benutzer möglicherweise zweimal aufgefordert, einen Treiber auszuwählen.

Wenn ein Installationsprogramm eine benutzerdefinierte Auswahlseite bereitstellt, muss das Installationsprogramm den ausgewählten Treiber festlegen. Im Code des Installers, der die Assistentenseite unterstützt, muss das Installationsprogramm SetupDiSetSelectedDriver aufrufen, nachdem der Benutzer auf Weiter geklickt hat.

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.