DIF_INSTALLDEVICEFILES
Met een DIF_INSTALLDEVICEFILES aanvraag kan een installatieprogramma deelnemen aan het kopiëren van de bestanden ter ondersteuning van een apparaat of een lijst maken met de bestanden voor een apparaat. De apparaatbestanden bevatten bestanden voor het geselecteerde stuurprogramma, alle apparaatinterfaces en eventuele co-installatieprogramma's.
Wanneer verzonden
De door het systeem geleverde apparaatinstallatieonderdelen deze DIF-aanvraag om verschillende redenen verzenden. Sommige onderdelen van de installatie van apparaten verzenden deze DIF-aanvraag vóór DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES en DIF_INSTALL_DEVICE om ervoor te zorgen dat alle relevante bestanden kunnen worden gekopieerd voordat u doorgaat met de installatie. Sommige onderdelen van de installatie van apparaten laten deze DIF-aanvraag weg en verwachten dat de bestanden worden gekopieerd tijdens de verwerking van deze drie DIF-aanvragen. Bovendien verzenden sommige onderdelen van de installatie van apparaten deze DIF-aanvraag om de lijst op te halen met de bestanden die zijn gekoppeld aan een apparaat.
Wie verwerkt
Co-installatieprogramma van klasse |
Kan verwerken |
Co-installatieprogramma voor apparaten |
Verwerkt niet |
Klasse-installatieprogramma |
Kan verwerken |
Invoer van installatieprogramma
DeviceInfoSet-
Levert een ingang aan de apparaatgegevensset die het apparaat bevat waarvan de ondersteunende bestanden moeten worden gekopieerd.
DeviceInfoData-
Hiermee wordt een aanwijzer geleverd aan een SP_DEVINFO_DATA structuur waarmee het apparaat in de gegevensset van het apparaat wordt geïdentificeerd.
parameters voor apparaatinstallatie
Er zijn apparaatinstallatieparameters (SP_DEVINSTALL_PARAMS) gekoppeld aan de DeviceInfoData-.
Als de vlag DI_NOVCP is ingesteld, bevatten de installatieparameters van het apparaat een geldige FileQueue ingangen en installatieprogramma's waarmee deze DIF-aanvraag wordt verwerkt, worden hun bestandsbewerkingen aan deze wachtrij toegevoegd en worden de wachtrij niet doorgevoerd.
installatieparameters van klasse
Geen
Uitvoer van installatieprogramma
parameters voor apparaatinstallatie
Een installatieprogramma kan de FileQueue-wijzigen, indien aanwezig.
Retourwaarde van installatieprogramma
Een co-installatieprogramma kan NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED of een Win32-foutcode retourneren.
Als een klasse-installatieprogramma deze aanvraag verwerkt en SetupDiCallClassInstaller vervolgens de standaardhandler moet aanroepen, retourneert het klasse-installatieprogramma ERROR_DI_DO_DEFAULT.
Als het installatieprogramma van de klasse deze aanvraag verwerkt, inclusief het rechtstreeks aanroepen van de standaardhandler, moet het installatieprogramma van de klasse NO_ERROR retourneren en SetupDiCallClassInstaller de standaardhandler vervolgens niet meer aanroepen.
Opmerking Het installatieprogramma van de klasse kan de standaardhandler rechtstreeks aanroepen, maar het installatieprogramma van de klasse mag nooit proberen de bewerkingen van de standaardhandler te vervangen.
Zie Standaard-DIF-codehandlers aanroepenvoor meer informatie over het aanroepen van de standaardhandler.
Als er een fout optreedt in het klasse-installatieprogramma, moet het installatieprogramma een geschikte Win32-foutcode retourneren en SetupDiCallClassInstaller vervolgens de standaardhandler niet aanroepen.
Standaard DIF-codehandler
Installatieprogramma
Als reactie op een DIF_INSTALLDEVICEFILES een installatieprogramma aanvragen, worden eventuele benodigde bestandsbewerkingen opgegeven. Een installatieprogramma kan bijvoorbeeld opgeven dat een extra bestand moet worden gekopieerd dat vereist is voor de installatie van het apparaat. Als de vlag DI_NOVCP is ingesteld, geeft een installatieprogramma bestandsbewerkingen op door ze toe te voegen aan de FileQueue- in de installatieparameters van het apparaat. Zie de Microsoft Windows SDK voor informatie over het gebruik van bestandswachtrijen en voor referentiepagina's over bestandswachtrijen, zoals SetupInstallFilesFromInfSection-.
Als deze DIF-aanvraag wordt verzonden tijdens de installatie van het apparaat en het installatieprogramma een Microsoft Win32-foutcode retourneert, stopt Windows de installatie.
Als een door het systeem geleverde apparaatinstallatieonderdeel deze DIF-aanvraag verzendt om een lijst op te halen met de bestanden die zijn gekoppeld aan een apparaat, haalt het onderdeel de bestandswachtrij op, maar voert de wachtrij niet door.
Zie Dif-codes verwerkenvoor meer informatie over DIF-codes.
Eisen
Versie |
Ondersteund in Microsoft Windows 2000 en latere versies van Windows. |
Rubriek |
Setupapi.h (inclusief Setupapi.h) |