DIF_INSTALLDEVICEFILES
Mit einer DIF_INSTALLDEVICEFILES Anforderung kann ein Installationsprogramm daran teilnehmen, die Dateien zu kopieren, um ein Gerät zu unterstützen 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.
Wann gesendet
Die vom System bereitgestellten Geräteinstallationskomponenten diese DIF-Anforderung aus verschiedenen Gründen senden. Einige Geräteinstallationskomponenten 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 Geräteinstallationskomponenten lassen diese DIF-Anforderung aus und erwarten, dass die Dateien während der Verarbeitung dieser drei DIF-Anforderungen kopiert werden. Darüber hinaus senden einige Geräteinstallationskomponenten diese DIF-Anforderung, um die Liste der Dateien abzurufen, die einem Gerät zugeordnet sind.
Wer behandelt
| Klassen-Co-Installer | Kann behandeln |
|---|---|
| Geräte-Co-Installer | Behandelt nicht |
| Klasseninstallationsprogramm | Kann behandeln |
Installer-Eingabe
DeviceInfoSet-
Stellt einen 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
Der DeviceInfoData-sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.
Wenn das DI_NOVCP Flag festgelegt ist, enthalten die Geräteinstallationsparameter eine gültige FileQueue Handle und Installer, die diese DIF-Anforderung verarbeiten, fügen ihre Dateivorgänge zu dieser Warteschlange hinzu und übernehmen sie nicht.
Klasseninstallationsparameter
Nichts
Installationsprogrammausgabe
Geräteinstallationsparameter
Ein Installationsprogramm kann die FileQueue-ändern, falls 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 sollte dann den Standardhandler aufrufen, gibt das Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT zurück.
Wenn das Klasseninstallationsprogramm diese Anforderung erfolgreich verarbeitet, einschließlich des direkten Aufrufens des Standardhandlers, sollte das Klasseninstallationsprogramm NO_ERROR zurückgeben und SetupDiCallClassInstaller den Standardhandler nicht erneut aufrufen.
Anmerkung
Das Klasseninstallationsprogramm kann den Standardhandler direkt aufrufen, aber das Klasseninstallationsprogramm sollte niemals versuchen, die Vorgänge des Standardhandlers zu ersetzen.
Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von standardmäßigen DIF-Codehandlern.
Wenn beim Klasseninstallationsprogramm ein Fehler auftritt, sollte das Installationsprogramm einen entsprechenden Win32-Fehlercode zurückgeben und SetupDiCallClassInstaller den Standardhandler nicht aufruft.
Standardmäßiger DIF-Codehandler
Installer-Vorgang
Als Reaktion auf eine DIF_INSTALLDEVICEFILES Anforderung gibt ein Installationsprogramm alle erforderlichen Dateivorgänge an. Ein Installationsprogramm kann z. B. eine andere Datei angeben, die für die Geräteinstallation erforderlich ist. Wenn das DI_NOVCP-Flag festgelegt ist, gibt ein Installationsprogramm Dateivorgänge an, indem sie der FileQueue- in den Geräteinstallationsparametern hinzugefügt werden. Informationen zur Verwendung von Dateiwarteschlangen und Referenzseiten auf Dateiwarteschlangen wie SetupInstallFilesFromInfSectionfinden Sie im Microsoft Windows SDK.
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 dateien abzurufen, die einem Gerät zugeordnet sind, ruft die Komponente die Dateiwarteschlange ab, führt jedoch keinen Commit für die Warteschlange durch.
Weitere Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes.
Anforderungen
| Version | Microsoft Windows 2000 und höher |
| Kopfball | Setupapi.h (include Setupapi.h) |