Função ExRundownCompleted (wdm.h)

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

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 em execução 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. 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 objeto associado retornam imediatamente sem esperar. No entanto, chama ExAcquireRundownProtection para adquirir a proteção de run down 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 run down no novo objeto.

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

Para obter mais informações, consulte Proteção contra run-down.

Requisitos

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

Confira também

EX_RUNDOWN_REF

ExInitializeRundownProtection