Compartilhar via


Função ExRundownCompleted (wdm.h)

A rotina ExRundownCompleted atualiza o status de execução de um objeto compartilhado para indicar que a execução do objeto foi concluída.

Sintaxe

void ExRundownCompleted(
  [out] PEX_RUNDOWN_REF RunRef
);

Parâmetros

[out] RunRef

Um ponteiro para uma estrutura EX_RUNDOWN_REF que foi inicializada por uma chamada anterior para a rotina ExInitializeRundownProtection. As rotinas de proteção executadas usam essa estrutura para acompanhar o status de execução do objeto compartilhado associado. Essa estrutura é opaca para drivers.

Valor de retorno

Nenhum

Observações

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

Após uma chamada ExRundownCompleted, chamadas adicionais para ExWaitForRundownProtectionRelease para executar o retorno do objeto associado imediatamente sem esperar. No entanto, chamadas para ExAcquireRundownProtection para adquirir a proteção de execução na falha do objeto associado (retornar false).

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

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

Para obter mais informações, consulte Run-Down Protection.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows XP.
da Plataforma de Destino Universal
cabeçalho wdm.h (inclua Wdm.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte também

EX_RUNDOWN_REF

ExInitializeRundownProtection