ExRundownCompleted, fonction (wdm.h)
La routine ExRundownCompleted met à jour l’état d’exécution d’un objet partagé pour indiquer que l’exécution de l’objet est terminée.
Syntaxe
void ExRundownCompleted(
[out] PEX_RUNDOWN_REF RunRef
);
Paramètres
[out] RunRef
Pointeur vers une structure EX_RUNDOWN_REF qui a été initialisée par un appel précédent à la routine ExInitializeRundownProtection. Les routines de protection de l’exécution utilisent cette structure pour suivre l’état d’exécution de l’objet partagé associé. Cette structure est opaque pour les pilotes.
Valeur de retour
Aucun
Remarques
Cette routine est appelée par le pilote propriétaire d’un objet qui réside dans la mémoire partagée et accessible par d’autres pilotes. L’appel ExRundownCompleted doit être précédé d’un appel à l'ExWaitForRundownProtectionRelease routine qui exécute l’objet.
Après un appel ExRundownCompleted, des appels supplémentaires à ExWaitForRundownProtectionRelease pour exécuter immédiatement le retour de l’objet associé sans attendre. Toutefois, les appels à ExAcquireRundownProtection pour acquérir une protection d’exécution sur l’objet associé échouent (renvoyer FALSE).
Après un appel ExRundownCompleted, le pilote peut appeler la routine ExReInitializeRundownProtection pour associer la structure EX_RUNDOWN_REF à un nouvel objet et initialiser la protection d’exécution sur cet objet. Après l’appel ExReInitializeRundownProtection, les pilotes peuvent appeler ExAcquireRundownProtection pour acquérir une protection d’exécution sur le nouvel objet.
Lors de l’entrée, les informations d’état de la structure EX_RUNDOWN_REF doivent indiquer que l’objet associé à cette structure a été exécuté.
Pour plus d’informations, consultez Run-Down Protection.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows XP. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |