Função ExReInitializeRundownProtectionCacheAware (wdm.h)

Artigo
03/05/2024

A rotina ExReInitializeRundownProtectionCacheAware reinicializa uma estrutura EX_RUNDOWN_REF_CACHE_AWARE depois que o objeto associado é executado.

Sintaxe

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

Parâmetros

[in, out] RunRefCacheAware

Um ponteiro para uma estrutura EX_RUNDOWN_REF_CACHE_AWARE que foi inicializada por uma chamada anterior para ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionCacheAware. As rotinas de proteção de run down com reconhecimento de cache usam essa estrutura para acompanhar o run-down status do objeto compartilhado associado. Essa estrutura é opaca para os drivers.

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.

ExReInitializeRundownProtectionCacheAware permite que uma estrutura de EX_RUNDOWN_REF_CACHE_AWARE usada anteriormente seja associada a um novo objeto e inicializa a proteção de run down com reconhecimento de cache nesse objeto. Após a chamada ExReInitializeRundownProtectionCacheAware , os drivers podem chamar ExAcquireRundownProtectionCacheAware para adquirir a proteção de run down com reconhecimento de cache no novo objeto.

Uma chamada ExReInitializeRundownProtectionCacheAware deve ser precedida por uma chamada para a rotina ExWaitForRundownProtectionReleaseCacheAware que executa o objeto antigo. Entre as chamadas ExWaitForRundownProtectionReleaseCacheAware e ExReInitializeRundownProtectionCacheAware , o driver pode chamar a rotina ExRundownCompletedCacheAware para indicar que o run down do objeto antigo foi concluído.

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