Fonction ExRundownCompleted (wdm.h)

  • Article

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

Voir aussi

EX_RUNDOWN_REF

ExInitializeRundownProtection