Função ExRundownCompletedCacheAware (wdm.h)

Artigo
02/27/2024

A rotina ExRundownCompletedCacheAware atualiza o run-down status de um objeto compartilhado para indicar que o run down do objeto foi concluído.

Sintaxe

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

Parâmetros

[in, out] RunRefCacheAware

Ponteiro para o objeto de proteção de rundown no qual a função funcionará. Esse é um ponteiro para uma estrutura de EX_RUNDOWN_REF_CACHE_AWARE opaca retornada por uma chamada anterior para ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionCacheAware.

Retornar valor

Nenhum

Comentários

Essa rotina é chamada pelo driver que possui um objeto que reside na memória compartilhada e que é acessado por outros drivers. A chamada ExRundownCompletedCacheAware deve ser precedida por uma chamada para a rotina ExWaitForRundownProtectionReleaseCacheAware que executa o objeto.

Após uma chamada de ExRundownCompletedCacheAware , chamadas adicionais para ExWaitForRundownProtectionReleaseCacheAware para executar o objeto associado retornam imediatamente sem esperar. No entanto, chama ExAcquireRundownProtectionCacheAware para adquirir a proteção de run down na falha do objeto associado (retornar FALSE).

Após uma chamada exRundownCompletedCacheAware , o driver pode chamar a rotina ExReInitializeRundownProtectionCacheAware para associar a estrutura EX_RUNDOWN_REF_CACHE_AWARE a um novo objeto e inicializar a proteção de run-down nesse objeto. Após a chamada ExReInitializeRundownProtection , os drivers podem chamar ExAcquireRundownProtectionCacheAware para adquirir a proteção de run down no novo objeto.

Na entrada, as informações de status na estrutura EX_RUNDOWN_REF_CACHE_AWARE devem indicar que o objeto associado a essa estrutura foi executado.