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

Confira também

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection