ExReInitializeRundownProtectionCacheAware, fonction (wdm.h)

Article
02/07/2025

L'ExReInitializeRundownProtectionCacheAware routine réinitialise une structure EX_RUNDOWN_REF_CACHE_AWARE une fois l’objet associé exécuté.

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 qui a été initialisée par un appel précédent à ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionCacheAware. Les routines de protection d’exécution prenant en compte le cache utilisent cette structure pour suivre l’état d’exécution de l’objet partagé associé. Cette structure est opaque pour les pilotes.

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.

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 à l'ExWaitForRundownProtectionReleaseCacheAware routine qui exécute l’ancien objet. Entre le ExWaitForRundownProtectionReleaseCacheAware et ExReInitializeRundownProtectionCacheAware appels, 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 d’état de la structure EX_RUNDOWN_REF_CACHE_AWARE doivent indiquer que l’ancien objet a été exécuté.