Partager via

Implémentation d’actions Finish-Install

  • Article

Notes

Les fonctionnalités décrites dans cette section ne sont pas prises en charge dans les packages de pilotes universels ou mobiles. Consultez Utilisation d’un fichier INF universel.

Les programmes d’installation (programme d’installation de classe, co-programme d’installation de classe ou co-programme d’installation d’appareil) fournissent des actions de fin-installation. Une action terminer-installer peut exécuter un programme exécutable, créer un processus, créer un thread ou exécuter du code dans le processus de fin d’installation et d’installation du pilote de périphérique.

Pour implémenter des actions terminer-installer, un programme d’installation :

  1. Définit l’indicateur DI_FLAGSEX_FINISHINSTALL_ACTION lorsque le programme d’installation traite un code DIF DIF_NEWDEVICEWIZARD_FINISHINSTALL et retourne l’un des codes d’erreur suivants :

    • ERROR_DI_DO_DEFAULT s’il s’agit d’un programme d’installation de classe sans pages de l’Assistant Terminer l’installation.
    • NO_ERROR s’il s’agit d’un programme d’installation de classe avec des pages de l’Assistant Fin-installation ou d’un co-programme d’installation avec ou sans pages de l’Assistant Terminer-installer.

  2. Effectue les actions de fin-installation lorsqu’il traite une demande de DIF_FINISHINSTALL_ACTION .

    Un programme d’installation retourne l’un des codes d’erreur du tableau suivant.

    Code d'erreur Signification

    ERROR_DI_DO_DEFAULT

    Programme d’installation de classe : le programme d’installation de classe a correctement exécuté ses actions de fin d’installation et demande à Windows d’effectuer son traitement par défaut. Un programme d’installation de classe doit également retourner ce code d’erreur s’il n’a aucune action terminer-installer.

    Co-programme d’installation d’appareil ou de classe : les co-programmes d’installation ne retournent pas ce code d’erreur.

    NO_ERROR

    Programme d’installation de classe : le programme d’installation de classe a correctement exécuté son action terminer-installer. Windows ne doit pas effectuer son traitement par défaut.

    Co-programme d’installation d’appareil ou de classe : le co-programme d’installation a correctement exécuté ses actions de fin-installation ou n’a aucune action terminer-installer.

    Erreur Microsoft Win32

    Le programme d’installation a rencontré une erreur, mais l’action terminer-installer doit être tentée à nouveau. Le renvoi d’un code d’erreur Win32 indique que Windows doit exécuter un autre processus de fin d’installation pour terminer l’installation la prochaine fois que l’appareil est énuméré.

Note Si une action terminer-installer échoue et ne doit pas être tentée à nouveau, un programme d’installation de classe retourne ERROR_DI_DO_DEFAULT et un appareil ou un co-programme d’installation de classe retourne NO_ERROR.

Pour plus d’informations sur le développement d’actions de fin-installation, consultez Instructions d’implémentation d’actions de Finish-Install Pour obtenir un exemple de code qui montre comment implémenter des actions de fin-installation, consultez les rubriques suivantes :

Exemple de code : actions Finish-Install dans un programme d’installation de classe

Exemple de code : actions Finish-Install dans un co-programme d’installation