Fonction ExRundownCompletedCacheAware (wdm.h)

Article
02/27/2024

La routine ExRundownCompletedCacheAware 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 ExRundownCompletedCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Paramètres

[in, out] RunRefCacheAware

Pointeur vers l’objet de protection d’exécution sur lequel la fonction fonctionnera. Il s’agit d’un pointeur vers une structure de EX_RUNDOWN_REF_CACHE_AWARE opaque retournée par un appel précédent à ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionAware.

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 ExRundownCompletedCacheAware doit être précédé d’un appel à la routine ExWaitForRundownProtectionReleaseCacheAware qui exécute l’objet.

Après un appel ExRundownCompletedCacheAware , des appels supplémentaires à ExWaitForRundownProtectionReleaseCacheAware pour exécuter l’objet associé retournent immédiatement sans attendre. Toutefois, les appels à ExAcquireRundownProtectionCacheAware pour acquérir une protection d’exécution sur l’objet associé échouent ( retournez FALSE).

Après un appel ExRundownCompletedCacheAware , le pilote peut appeler la routine ExReInitializeRundownProtectionCacheAware pour associer la structure EX_RUNDOWN_REF_CACHE_AWARE à un nouvel objet et initialiser la protection contre l’exécution sur cet objet. Après l’appel ExReInitializeRundownProtection , les pilotes peuvent appeler ExAcquireRundownProtectionCacheAware 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_CACHE_AWARE doivent indiquer que l’objet associé à cette structure a été exécuté.