ExRundownCompletedCacheAware, fonction (wdm.h)

Article
02/07/2025

La routine ExRundownCompletedCacheAware 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 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 ExInitializeRundownProtectionCacheAware.

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

Après un appel ExRundownCompletedCacheAware, des appels supplémentaires à ExWaitForRundownProtectionReleaseCacheAware pour exécuter immédiatement l’objet associé sans attendre. Toutefois, les appels à ExAcquireRundownProtectionCacheAware pour acquérir une protection d’exécution sur l’objet associé échouent (renvoyer 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 d’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 d’état de la structure EX_RUNDOWN_REF_CACHE_AWARE doivent indiquer que l’objet associé à cette structure a été exécuté.