Função ExWaitForRundownProtectionRelease (wdm.h)
A rotina ExWaitForRundownProtectionRelease aguarda até que todos os drivers que já receberam proteção de execução concluam seus acessos do objeto compartilhado.
Sintaxe
void ExWaitForRundownProtectionRelease(
[in, out] PEX_RUNDOWN_REF RunRef
);
Parâmetros
[in, 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. Antes de excluir esse objeto, o driver proprietário deve chamar essa rotina para aguardar a conclusão de todos os acessos pendentes do objeto. Depois que ExWaitForRundownProtectionRelease retorna, o driver proprietário pode excluir o objeto com segurança.
Depois que ExWaitForRundownProtectionRelease for chamado, o exAcquireRundownProtection rotina não concederá mais solicitações de proteção de execução contra drivers que estão tentando acessar o objeto compartilhado. A rotina aguarda o retorno até que todos os drivers que receberam proteção executada anteriormente terminem de acessar o objeto. À medida que cada driver é concluído, ele chama a rotina exReleaseRundownProtection para liberar a proteção de run-down adquirida anteriormente. Quando todos os acessos pendentes são concluídos, ExWaitForRundownProtectionRelease retorna e o objeto pode ser excluído com segurança.
Se ExWaitForRundownProtectionRelease for chamado quando todos os drivers que receberam proteção run-down previamente já tiverem terminado de acessar o objeto compartilhado, a rotina alterará o status do objeto para executare retornar imediatamente, sem esperar.
Se ExWaitForRundownProtectionRelease for chamado para executar um objeto compartilhado, mas o parâmetro RunRef indicar que esse objeto já está executado, a chamada não terá efeito, mas não será tratada como um erro.
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 |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), SpNoWait(storport) |