Fonction ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Article
02/27/2024

La routine ExAcquireRundownProtectionCacheAwareEx tente d’acquérir une protection d’exécution prenant en compte le cache sur un objet partagé afin que l’appelant puisse accéder en toute sécurité à l’objet.

Syntaxe

BOOLEAN ExAcquireRundownProtectionCacheAwareEx(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]      ULONG                       Count
);

Paramètres

[in, out] RunRefCacheAware

Pointeur vers la structure opaque EX_RUNDOWN_REF_CACHE_AWARE retournée par un appel précédent à ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtection.

[in] Count

Quantité d’incrémentation vers l’instance nombre de l’objet. Le nombre est incrémenté uniquement si la routine retourne TRUE. Pour plus d'informations, consultez la section Notes.

Valeur retournée

ExAcquireRundownProtectionCacheAwareEx retourne TRUE si la routine acquiert correctement la protection contre l’exécution de l’appelant. Sinon, il retourne FALSE. Une valeur de retour FALSE indique que l’exécution de l’objet a démarré et que l’objet doit être traité comme non valide.

Remarques

Le paramètre RunRefCacheAware pointe vers une structure EX_RUNDOWN_REF_CACHE_AWARE qui effectue le suivi des status d’exécution de l’objet associé. Ces informations status incluent le nombre d’instances de protection d’exécution prenant en charge le cache qui sont actuellement en vigueur sur l’objet. Les routines ExAcquireRundownProtectionCacheAwareEx et ExReleaseRundownProtectionCacheAwareEx incrémentent et décrémentent ce nombre selon des quantités arbitraires. Deux routines associées, ExAcquireRundownProtectionCacheAware et ExReleaseRundownProtectionCacheAware, incrémentent et décrémentent ce nombre d’une.

Tant que le bloc d’exécution lui-même n’est pas paginé, cette fonction peut être appelée à DISPATCH_LEVEL.

Pour plus d’informations, consultez Protection d’exécution prenant en charge le cache.

Configuration requise

Condition requise	Valeur
Serveur minimal pris en charge	Windows Server 2003, Service Pack 1
En-tête	wdm.h (inclure Wdm.h)
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport)