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 |