DIF_INSTALLINTERFACES
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) |