Función ExRundownCompletedCacheAware (wdm.h)

Artículo
03/05/2024

La rutina ExRundownCompletedCacheAware actualiza el estado de ejecución de un objeto compartido para indicar que se ha completado la ejecución del objeto.

Sintaxis

void ExRundownCompletedCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Parámetros

[in, out] RunRefCacheAware

Puntero al objeto de protección de detención en el que funcionará la función. Se trata de un puntero a una estructura de EX_RUNDOWN_REF_CACHE_AWARE opaca devuelta por una llamada anterior a ExAllocateCacheAwareRundownProtection o ExInitializeRundownProtectionCacheAware.

Valor devuelto

None

Observaciones

El controlador llama a esta rutina que posee un objeto que reside en la memoria compartida y a la que acceden otros controladores. La llamada exRundownCompletedCacheAware debe ir precedida de una llamada a la rutina ExWaitForRundownProtectionReleaseCacheAware que ejecuta el objeto.

Después de una llamada exRundownCompletedCacheAware , las llamadas adicionales a ExWaitForRundownProtectionReleaseCacheAware para ejecutar el objeto asociado se devuelven inmediatamente sin esperar. Sin embargo, las llamadas a ExAcquireRundownProtectionCacheAware para adquirir protección de ejecución en el objeto asociado producen un error (devuelve FALSE).

Después de una llamada exRundownCompletedCacheAware , el controlador puede llamar a la rutina ExReInitializeRundownProtectionCacheAware para asociar la estructura de EX_RUNDOWN_REF_CACHE_AWARE con un nuevo objeto y para inicializar la protección de ejecución en este objeto. Después de la llamada ExReInitializeRundownProtection , los controladores pueden llamar a ExAcquireRundownProtectionCacheAware para adquirir protección de ejecución en el nuevo objeto.

En la entrada, la información de estado de la estructura EX_RUNDOWN_REF_CACHE_AWARE debe indicar que el objeto asociado a esta estructura se ha ejecutado.