Função ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Artigo
02/27/2024

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

Sintaxe

BOOLEAN ExAcquireRundownProtectionCacheAwareEx(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]      ULONG                       Count
);

Parâmetros

[in, out] RunRefCacheAware

Ponteiro para a estrutura de EX_RUNDOWN_REF_CACHE_AWARE opaca retornada por uma chamada anterior para ExAllocateCacheAwareRundownProtection ou ExInitializeRundownProtectionCacheAware.

[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

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

Comentários

O parâmetro RunRefCacheAware aponta para uma estrutura EX_RUNDOWN_REF_CACHE_AWARE que rastreia a status de execução do objeto associado. Essas informações status incluem uma contagem de instâncias de proteção de run down com reconhecimento de cache que estão atualmente em vigor no objeto . As rotinas ExAcquireRundownProtectionCacheAwareEx e ExReleaseRundownProtectionCacheAwareEx incrementam e decrementam essa contagem por quantidades arbitrárias. Duas rotinas relacionadas, ExAcquireRundownProtectionCacheAware e ExReleaseRundownProtectionCacheAware, incrementam e decrementam essa contagem em um.

Desde que o bloco de execução em si não sejapagizado, essa função pode ser chamada em DISPATCH_LEVEL.

Para obter mais informações, consulte Proteção de run down com reconhecimento de cache.

Requisitos

Requisito	Valor
Servidor mínimo com suporte	Windows Server 2003, Service Pack 1
Cabeçalho	wdm.h (include Wdm.h)
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport)