Função ExInitializeRundownProtection (wdm.h)
A rotina ExInitializeRundownProtection inicializa a proteção de run-down em um objeto compartilhado.
Sintaxe
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
Parâmetros
[out] RunRef
Um ponteiro para uma estrutura de EX_RUNDOWN_REF alocada pelo chamador que deve ser inicializada. A alocação deve ser alinhada a 4 bytes em plataformas de 32 bits e alinhada a 8 bytes em plataformas de 64 bits. Para obter mais informações, consulte Comentários.
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.
ExInitializeRundownProtection deve ser chamado para inicializar uma estrutura de EX_RUNDOWN_REF antes de ser passada como um parâmetro para qualquer outra rotina de proteção de run-down.
As rotinas de proteção de execução usam a estrutura EX_RUNDOWN_REF para acompanhar o status de execução de um objeto compartilhado associado à estrutura. Essas informações de status incluem uma contagem de instâncias de proteção em execução que estão atualmente em vigor no objeto. ExInitializeRundownProtection inicializa essa contagem como zero.
Depois que uma estrutura de EX_RUNDOWN_REF é inicializada, outros drivers que acessam o objeto associado podem chamar o ExAcquireRundownProtection e rotinas de ExReleaseRundownProtection para adquirir e liberar a proteção de run-down no objeto.
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 |