Fonction ExRundownCompleted (wdm.h)
La routine ExRundownCompleted met à jour la status 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 d’exécution utilisent cette structure pour suivre les status d’exécution de l’objet partagé associé. Cette structure est opaque pour les pilotes.
Valeur de retour
None
Remarques
Cette routine est appelée par le pilote qui possède un objet qui réside dans la mémoire partagée et auquel d’autres pilotes accèdent. L’appel ExRundownCompleted doit être précédé d’un appel à la routine ExWaitForRundownProtectionRelease qui exécute l’objet.
Après un appel ExRundownCompleted , des appels supplémentaires à ExWaitForRundownProtectionRelease pour exécuter l’objet associé retournent immédiatement sans attendre. Toutefois, les appels à ExAcquireRundownProtection pour acquérir une protection contre l’exécution sur l’objet associé échouent (retourne 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 contre l’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 status dans la structure EX_RUNDOWN_REF doivent indiquer que l’objet associé à cette structure a été exécuté.
Pour plus d’informations, consultez Protection contre les pannes.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows XP. |
Plateforme cible | Universal |
En-tête | wdm.h (inclure Wdm.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |