DIF_INSTALLDEVICEFILES
Eine DIF_INSTALLDEVICEFILES-Anforderung ermöglicht es einem Installationsprogramm, am Kopieren der Dateien zur Unterstützung eines Geräts teilzunehmen oder eine Liste der Dateien für ein Gerät zu erstellen. Die Gerätedateien enthalten Dateien für den ausgewählten Treiber, alle Geräteschnittstellen und alle Co-Installer.
Sendebedingungen
Die vom System bereitgestellten Geräteinstallationskomponenten senden diese DIF-Anforderung aus verschiedenen Gründen. Einige Komponenten der Geräteinstallation senden diese DIF-Anforderung vor DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES und DIF_INSTALL_DEVICE, um sicherzustellen, dass alle relevanten Dateien kopiert werden können, bevor sie mit der Installation fortfahren. Einige Komponenten der Geräteinstallation lassen diese DIF-Anforderung aus und erwarten, dass die Dateien während der Behandlung dieser drei DIF-Anforderungen kopiert werden. Darüber hinaus senden einige Geräteinstallationskomponenten diese DIF-Anforderung, um die Liste der einem Gerät zugeordneten Dateien abzurufen.
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, dessen unterstützende Dateien kopiert werden sollen.
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.
Wenn das flag DI_NOVCP festgelegt ist, enthalten die Geräteinstallationsparameter ein gültiges FileQueue-Handle , und Installationsprogramme, die diese DIF-Anforderung verarbeiten, fügen ihre Dateivorgänge zu dieser Warteschlange hinzu und committen die Warteschlange nicht.
Klasseninstallationsparameter
Keine
Installationsprogrammausgabe
Geräteinstallationsparameter
Ein Installationsprogramm kann die FileQueue ändern, sofern vorhanden.
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
Installer-Vorgang
Als Reaktion auf eine DIF_INSTALLDEVICEFILES Anforderung gibt ein Installationsprogramm alle erforderlichen Dateivorgänge an. Beispielsweise kann ein Installationsprogramm eine zusätzliche Zu kopierende Datei angeben, die für die Geräteinstallation erforderlich ist. Wenn das flag DI_NOVCP festgelegt ist, gibt ein Installationsprogramm Dateivorgänge an, indem es sie der FileQueue in den Geräteinstallationsparametern hinzufügt. Im Microsoft Windows SDK finden Sie Informationen zur Verwendung von Dateiwarteschlangen und Referenzseiten für Dateiwarteschlangenfunktionen wie SetupInstallFilesFromInfSection.
Wenn diese DIF-Anforderung während der Geräteinstallation gesendet wird und das Installationsprogramm einen Microsoft Win32-Fehlercode zurückgibt, beendet Windows die Installation.
Wenn eine vom System bereitgestellte Geräteinstallationskomponente diese DIF-Anforderung sendet, um eine Liste der einem Gerät zugeordneten Dateien abzurufen, ruft die Komponente die Dateiwarteschlange ab, aber keine Commits für die Warteschlange.
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) |