DIF_FIRSTTIMESETUP

Artikel
06/15/2023

Dieser DIF-Code ist für die Systemverwendung reserviert. Vom Anbieter bereitgestellte Installationsprogramme dürfen diese Anforderung nur verarbeiten, wenn der Anbieter Nicht-PnP-Geräte bereitstellt, die vom Installationsprogramm erkannt werden müssen.

Eine DIF_FIRSTTIMESETUP Anforderung weist ein Installationsprogramm an, alle klassenspezifischen Installationsaufgaben auszuführen, die während der Erstinstallation des Betriebssystems ausgeführt werden müssen.

Sendebedingungen

Während der Einrichtung des GUI-Modus.

Wer behandelt

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

Eingabe des Installationsprogramms

DeviceInfoSet
Stellt dem Geräteinformationssatz ein Handle bereit. Dem DeviceInfoSet ist eine Gerätesetupklasse zugeordnet.

DeviceInfoData
Keine

Geräteinstallationsparameter
Dem DeviceInfoSet sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.

Klasseninstallationsparameter
Keine

Installationsprogrammausgabe

DeviceInfoSet
Ein Installationsprogramm fügt dem DeviceInfoSet für jedes erkannte Gerät, das installiert werden soll, ein Geräteinformationselement hinzu. Ein Installationsprogramm kann auch eine globale Klassentreiberliste erstellen.

Geräteinstallationsparameter
Ein Installationsprogramm kann die Geräteinstallationsparameter für das DeviceInfoSet oder für neue Geräteinformationselemente ändern, die erstellt werden.

Rückgabewert des Installers

Ein Klassen-Co-Installer kann Geräte während der Vor- oder Nachverarbeitung erkennen. Ein solcher Co-Installer gibt nach seinen Erkennungsvorgängen ERROR_DI_POSTPROCESSING_REQUIRED (für die Nachverarbeitung) und/oder NO_ERROR oder einen Win32-Fehlercode zurück. Wenn ein Co-Installer keine Geräte erkennt, gibt es NO_ERROR aus seinem Vorverarbeitungsdurchlauf zurück.

Wenn ein Klasseninstallationsprogramm Geräte erkennt, gibt das Installationsprogramm NO_ERROR oder einen entsprechenden Win32-Fehlercode zurück. Wenn ein Klasseninstallationsprogramm diese DIF-Anforderung nicht verarbeitet, gibt das Installationsprogramm ERROR_DI_DO_DEFAULT zurück.

Standard-DIF-Codehandler

Keine

Installer-Vorgang

Um Nicht-PnP-Geräte während der Einrichtung des GUI-Modus zu erkennen, muss ein Installationsprogramm die DIF_FIRSTTIMESETUP-Anforderung verarbeiten. Das Gui-Modus-Setup sendet keine DIF_DETECT-Anforderung an das Installationsprogramm.

Setup im GUI-Modus sendet eine DIF_FIRSTTIMESETUP-Anforderung mit einem leeren DeviceInfoSet. Die Installationsprogramme können die Legacyerkennung von Nicht-PnP-Geräten durchführen und sie dem DeviceInfoSet hinzufügen. Vom System bereitgestellte Installationsprogramme können diese DIF-Anforderung auch verarbeiten, wenn Ältere Geräteinstallationen von Windows 9x/Me oder Windows NT zu Microsoft Windows 2000 und höheren Versionen von Windows migriert werden.

Ein Installationsprogramm erkennt neue Geräte seiner Setupklasse basierend auf Registrierungsinformationen, indem es eine Kernelmoduserkennungskomponente aufruft oder unattend.txt Informationen aufruft, die gespeichert werden, wenn eine Migrations-DLL während eines Betriebssystemupgrades ausgeführt wurde.

Wenn ein Installationsprogramm ein Nicht-PnP-Gerät erkennt, sollte das Installationsprogramm wie folgt einen Treiber für das Gerät auswählen: Erstellen Sie ein Geräteinformationselement (SetupDiCreateDeviceInfo), legen Sie die SPDRP_HARDWAREID-Eigenschaft fest, indem Sie SetupDiSetDeviceRegistryProperty aufrufen, SetupDiBuildDriverInfoList aufrufen und dann SetupDiCallClassInstaller aufrufen, um eine DIF_SELECTBESTCOMPATDRV Anforderung zu senden.

Wenn ein oder mehrere Installationsprogramme als Reaktion auf diesen DIF-Code Geräte erkennen, versucht das GUI-Modus-Setup, die Geräte zu installieren. Setup im GUI-Modus versucht, alle Geräte in der Liste zu installieren; Wenn ein Installationsprogramm ein zuvor konfiguriertes Gerät zurückgibt, wird das Gerät im GUI-Modus zweimal installiert.

Ein Installationsprogramm muss diese DIF-Anforderung im Hintergrund verarbeiten. Das heißt, ohne dem Benutzer die Benutzeroberfläche anzuzeigen.

Installationsprogramme sollten keine Aufgaben ausführen, wenn sie diese DIF-Anforderung verarbeiten, die einen Neustart des Computers erfordern. Beispielsweise sollte ein Klasseninstallationsprogramm nicht festlegen, dass Treiber beim nächsten Start geladen werden, um festzustellen, welche Treiber nach dem Neustart erfolgreich sind.

Um Nicht-PnP-Geräte während der Einrichtung im GUI-Modus zu erkennen, muss ein Installationsprogramm diese Anforderung verarbeiten. Das Gui-Modus-Setup sendet keine DIF_DETECT-Anforderung.

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