Função ExAcquireRundownProtectionEx (wdm.h)

  • Artigo

A rotina ExAcquireRundownProtectionEx tenta adquirir a proteção de execução em um objeto compartilhado para que o chamador possa acessar o objeto com segurança.

Sintaxe

BOOLEAN ExAcquireRundownProtectionEx(
  [in, out] PEX_RUNDOWN_REF RunRef,
  [in]      ULONG           Count
);

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 em execução usam essa estrutura para acompanhar o run-down status do objeto compartilhado associado. Essa estrutura é opaca para os drivers.

[in] Count

O valor pelo qual incrementar para a contagem de instâncias em execução do objeto. A contagem será incrementada somente se a rotina retornar TRUE. Para obter mais informações, consulte Comentários

Retornar valor

ExAcquireRundownProtectionEx retornará TRUE se a rotina adquirir com êxito a proteção de run down para o chamador. Caso contrário, retornará FALSE. Um valor retornado de FALSE indica que o run down do objeto foi iniciado e que o objeto deve ser tratado como inválido.

Comentários

Para acessar com segurança um objeto compartilhado, um driver chama ExAcquireRundownProtectionEx para adquirir a proteção de run down no objeto .

O parâmetro RunRef aponta para uma estrutura EX_RUNDOWN_REF que rastreia a status do objeto associado. Essas informações status incluem uma contagem de instâncias de proteção de run down que estão atualmente em vigor no objeto . As rotinas ExAcquireRundownProtectionEx e ExReleaseRundownProtectionEx incrementam e decrementam essa contagem por valores arbitrários. Duas rotinas relacionadas, ExAcquireRundownProtection e ExReleaseRundownProtection, incrementam e decrementam essa contagem por um.

Desde que o bloco run-down em si não sejapagado, essa função pode ser chamada em DISPATCH_LEVEL.

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 Server 2003.
Plataforma de Destino Universal
Cabeçalho wdm.h (inclua Wdm.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (consulte Comentários)
Regras de conformidade de DDI HwStorPortProhibitedDDIs(storport)

Confira também

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExInitializeRundownProtection

ExReleaseRundownProtection

ExReleaseRundownProtectionEx