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.
Retornar valor
Nenhum
Comentários
Essa rotina é chamada pelo driver que possui um objeto que reside na memória compartilhada e é acessada por outros drivers.
ExInitializeRundownProtection deve ser chamado para inicializar uma estrutura 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 run down usam a estrutura EX_RUNDOWN_REF para acompanhar o run-down status de um objeto compartilhado associado à estrutura . Essas informações de status incluem uma contagem de instâncias de proteção de execução inativa 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 as rotinas ExAcquireRundownProtection e ExReleaseRundownProtection para adquirir e liberar a proteção de execução no objeto.
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 (include Wdm.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |