DIF_INSTALLINTERFACES

Artikel
06/15/2023

Eine DIF_INSTALLINTERFACES-Anforderung ermöglicht es einem Installationsprogramm, an der Registrierung der Geräteschnittstellen für ein Gerät teilzunehmen.

Sendebedingungen

Nach der Registrierung von Geräte-Co-Installern, aber vor Abschluss der Geräteinstallation.

Wer behandelt

Klassen-Co-Installer	Kann verarbeiten
Geräte-Co-Installer	Kann verarbeiten
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
Keine

Installationsprogrammausgabe

Geräteinstallationsparameter
Ein Installationsprogramm kann die Geräteinstallationsparameter ändern, aber normalerweise nicht für diese DIF-Anforderung.

Rückgabewert des Installers

Ein Co-Installer kann NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED oder einen Win32-Fehlercode zurückgeben.

Wenn ein Klasseninstallationsprogramm diese Anforderung erfolgreich verarbeitet und SetupDiCallClassInstaller anschließend den Standardhandler aufrufen sollte, gibt das Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT zurück.

Wenn der Klasseninstaller diese Anforderung erfolgreich verarbeitet, einschließlich des direkten Aufrufs des Standardhandlers, sollte der Klasseninstaller NO_ERROR zurückgeben, und SetupDiCallClassInstaller ruft den Standardhandler anschließend nicht mehr auf.

Hinweis Der Klasseninstaller kann den Standardhandler direkt aufrufen, aber der Klasseninstaller sollte niemals versuchen, die Vorgänge des Standardhandlers abzulösen.

Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.

Wenn beim Klasseninstallationsprogramm ein Fehler auftritt, sollte das Installationsprogramm einen entsprechenden Win32-Fehlercode zurückgeben, und SetupDiCallClassInstaller ruft anschließend nicht den Standardhandler auf.

Standard-DIF-Codehandler

SetupDiInstallDeviceInterfaces

Installer-Vorgang

Als Reaktion auf eine DIF_INSTALLINTERFACES Anforderung kann ein Installationsprogramm eine Geräteschnittstelle programmgesteuert registrieren, anstatt die Schnittstelle über die INF-Datei registrieren zu lassen. In der Regel verarbeiten vom Anbieter bereitgestellte Installationsprogramme diese DIF-Anforderung nicht.

Sofern nicht das flag DI_NOFILECOPY festgelegt ist, sollte ein Installationsprogramm, das diese DIF-Anforderung verarbeitet, Dateien kopieren, die für die Geräteschnittstelle(n) erforderlich sind.

Wenn das flag DI_NOFILECOPY klar ist, aber das flag DI_NOVCP festgelegt ist, muss das Installationsprogramm alle Dateivorgänge in die angegebene Dateiwarteschlange stellen, darf die Warteschlange jedoch nicht committen.

Wenn ein Installationsprogramm eine Geräteschnittstelle registriert, muss eine Kernelmoduskomponente für das Gerät (z. B. ein Treiber) IoSetDeviceInterfaceState aufrufen, um die Schnittstelle zu aktivieren.

Wenn das Installationsprogramm einen Win32-Fehlercode zurückgibt, beendet Windows die Installation.

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

Requirements (Anforderungen)

Version	Unterstützt in Microsoft Windows 2000 und höheren Versionen von Windows.
Header	Setupapi.h (schließen Sie Setupapi.h ein)

Weitere Informationen