Función ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Artículo
02/27/2024

La rutina ExAcquireRundownProtectionCacheAwareEx intenta adquirir la protección de reducción de la memoria caché en un objeto compartido para que el autor de la llamada pueda acceder de forma segura al objeto.

Sintaxis

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

Parámetros

[in, out] RunRefCacheAware

Puntero a la estructura de EX_RUNDOWN_REF_CACHE_AWARE opaca devuelta por una llamada anterior a ExAllocateCacheAwareRundownProtection o ExInitializeRundownProtectionCacheAware.

[in] Count

Cantidad por la que se va a incrementar en el recuento de instancias de ejecución del objeto. El recuento solo se incrementa si la rutina devuelve TRUE. Para obtener más información, vea la sección Comentarios.

Valor devuelto

ExAcquireRundownProtectionCacheAwareEx devuelve TRUE si la rutina adquiere correctamente la protección de ejecución para el autor de la llamada. De lo contrario, devuelve FALSE. Un valor devuelto de FALSE indica que se ha iniciado la ejecución del objeto y que el objeto debe tratarse como no válido.

Comentarios

El parámetro RunRefCacheAware apunta a una estructura de EX_RUNDOWN_REF_CACHE_AWARE que realiza un seguimiento del estado de ejecución del objeto asociado. Esta información de estado incluye un recuento de instancias de protección de ejecución con reconocimiento de caché que están actualmente en vigor en el objeto. Las rutinas ExAcquireRundownProtectionCacheAwareEx y ExReleaseRundownProtectionCacheAwareEx incrementan y reducen este recuento por cantidades arbitrarias. Dos rutinas relacionadas, ExAcquireRundownProtectionCacheAware y ExReleaseRundownProtectionCacheAware, incrementan y reducen este recuento en uno.

Siempre que el propio bloque de ejecución no esté paginado, se puede llamar a esta función en DISPATCH_LEVEL.

Para obtener más información, consulte Protección de desaprotección con reconocimiento de caché.

Requisitos

Requisito	Value
Servidor mínimo compatible	Windows Server 2003, Service Pack 1
Encabezado	wdm.h (incluya Wdm.h)
Reglas de cumplimiento de DDI	HwStorPortProhibitedDDIs(storport)