Fonction ExReInitializeRundownProtectionCacheAware (wdm.h)

Article
03/05/2024

La routine ExReInitializeRundownProtectionCacheAware réinitialise une structure EX_RUNDOWN_REF_CACHE_AWARE après l’exécution de l’objet associé.

Syntaxe

void ExReInitializeRundownProtectionCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Paramètres

[in, out] RunRefCacheAware

Pointeur vers une structure EX_RUNDOWN_REF_CACHE_AWARE initialisée par un appel précédent à ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtection. Les routines de protection de l’exécution prenant en compte le cache 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.

ExReInitializeRundownProtectionCacheAware permet d’associer une structure EX_RUNDOWN_REF_CACHE_AWARE précédemment utilisée à un nouvel objet et initialise la protection d’exécution prenant en charge le cache sur cet objet. Après l’appel ExReInitializeRundownProtectionCacheAware , les pilotes peuvent appeler ExAcquireRundownProtectionCacheAware pour acquérir une protection d’exécution prenant en charge le cache sur le nouvel objet.

Un appel ExReInitializeRundownProtectionCacheAware doit être précédé d’un appel à la routine ExWaitForRundownProtectionReleaseCacheAware qui exécute l’ancien objet. Entre les appels ExWaitForRundownProtectionReleaseCacheAware et ExReInitializeRundownProtectionCacheAware , le pilote peut appeler la routine ExRundownCompletedCacheAware pour indiquer que l’exécution de l’ancien objet est terminée.

Lors de l’entrée, les informations status dans la structure EX_RUNDOWN_REF_CACHE_AWARE doivent indiquer que l’ancien objet a été exécuté.