Función ExInitializeRundownProtectionCacheAware (wdm.h)

Artículo
03/05/2024

Esta rutina inicializa un objeto de protección de ejecución compatible con la memoria caché.

Sintaxis

void ExInitializeRundownProtectionCacheAware(
  [out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]  SIZE_T                      RunRefSize
);

Parámetros

[out] RunRefCacheAware

Puntero a un búfer proporcionado por el autor de la llamada donde la rutina devuelve una estructura de EX_RUNDOWN_REF_CACHE_AWARE opaca. Vea Comentarios para obtener más información.

[in] RunRefSize

Especifica el tamaño, en bytes, del objeto de protección de ejecución.

Valor devuelto

None

Observaciones

La protección contra la ejecución es un mecanismo de sincronización que usa el kernel de Windows para limpiar de forma segura los recursos a los que pueden acceder varios subprocesos.

Esta función está optimizada para escenarios en los que los patrones de acceso a un recurso protegido son compatibles con la memoria caché, lo que significa que es probable que el mismo subproceso tenga acceso al recurso repetidamente y que diferentes subprocesos tengan acceso a diferentes partes del recurso. Al usar esta función en lugar de ExInitializeRundownProtection, un controlador puede reducir la probabilidad de contención de caché, donde varios subprocesos compiten por las mismas líneas de caché, lo que provoca una degradación del rendimiento.

Esta función se usa normalmente durante la fase de inicialización de un controlador, cuando configura los recursos que necesita para funcionar. El controlador llama a esta función para cada recurso que debe protegerse mediante la protección de la ejecución con reconocimiento de caché.

La estructura de EX_RUNDOWN_REF_CACHE_AWARE es una estructura opaca que se usa para administrar la protección contra la detención. El llamador debe llamar primero a ExSizeOfRundownProtectionCacheAware para determinar el tamaño adecuado para el objeto de protección de ejecución. A continuación, este tamaño se debe usar para asignar un búfer para el parámetro RunRefCacheAware y también se debe pasar como parámetro RunRefSize .