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 |