Función ExInitializeRundownProtectionCacheAware (wdm.h)
Esta rutina inicializa un objeto de protección de rundown 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 rundown.
Valor devuelto
Ninguno
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. Mediante el uso de 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 EX_RUNDOWN_REF_CACHE_AWARE es una estructura opaca que se usa para administrar la protección de la desaprotección. El autor de la llamada debe llamar primero a exSizeOfRundownProtectionCacheAware para determinar el tamaño adecuado para el objeto de protección de rundown. A continuación, este tamaño debe usarse para asignar un búfer para el parámetro runRefCacheAware de y también se debe pasar como el parámetro RunRefSize.
Requisitos
| Requisito | Valor |
|---|---|
| servidor mínimo admitido | Windows Server 2003, Service Pack 1 |
| encabezado de | wdm.h (incluya Wdm.h) |
| irQL | <= APC_LEVEL |
Consulte también
exAcquireRundownProtectionCacheAware
ExAcquireRundownProtectionCacheAwareEx
ExAllocateCacheAwareRundownProtection
ExFreeCacheAwareRundownProtection
exReInitializeRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAwareEx
exSizeOfRundownProtectionCacheAware