ExAcquireRundownProtectionCacheAwareEx, fonction (wdm.h)

Article
02/07/2025

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 de EX_RUNDOWN_REF_CACHE_AWARE opaque retournée par un appel précédent à ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionCacheAware.

[in] Count

Quantité par laquelle incrémenter le nombre d’instances d’exécution de l’objet. Le nombre est incrémenté uniquement si la routine retourne TRUE. Pour plus d’informations, consultez Remarques.

Valeur de retour

ExAcquireRundownProtectionCacheAwareEx retourne TRUE si la routine acquiert correctement la protection d’exécution pour l’appelant. Sinon, elle retourne FALSE. Une valeur de retour de 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 suit l’état d’exécution de l’objet associé. Ces informations d’état incluent le nombre d’instances de protection d’exécution prenant en charge le cache qui sont actuellement en vigueur sur l’objet. L'ExAcquireRundownProtectionCacheAwareEx et ExReleaseRundownProtectionCacheAwareEx routines incrémentent et décrémentent ce nombre par des montants arbitraires. Deux routines connexes, ExAcquireRundownProtectionCacheAware et ExReleaseRundownProtectionCacheAware, incrémenter et décrémenter ce nombre par un.

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.

Exigences

Exigence	Valeur
serveur minimum pris en charge	Windows Server 2003, Service Pack 1
d’en-tête	wdm.h (include Wdm.h)
règles de conformité DDI	HwStorPortProhibitedDDIs(storport)