Função ExEnterCriticalRegionAndAcquireResourceExclusive (wdm.h)

Artigo
02/27/2024

A rotina ExEnterCriticalRegionAndAcquireResourceExclusive primeiro entra em uma região crítica e, em seguida, adquire acesso exclusivo ao recurso especificado.

Sintaxe

PVOID ExEnterCriticalRegionAndAcquireResourceExclusive(
  PERESOURCE Resource
);

Parâmetros

Resource

[in, out] Um ponteiro para o recurso a ser adquirido para acesso exclusivo. Esse parâmetro aponta para uma estrutura ERESOURCE alocada pelo chamador. O chamador anteriormente alocou essa estrutura do pool nãopagado e a inicializou chamando a rotina ExInitializeResourceLite ou ExReinitializeResourceLite .

Retornar valor

Um ponteiro para uma estrutura opaca do sistema. Os drivers devem ignorar esse valor retornado.

Comentários

Se essa rotina for chamada quando o recurso especificado não estiver disponível imediatamente para acesso exclusivo, o thread de chamada será bloqueado até que o recurso esteja disponível.

Enquanto um thread de driver é executado na região crítica, as APCs de usuário do driver e as APCs de kernel normais não são executadas. ApCs de kernel especiais ainda são executadas. Para obter mais informações sobre esses tipos de APC, consulte Tipos de APCs.

Ao desabilitar temporariamente as APCs de kernel normais, ExEnterCriticalRegionAndAcquireResourceExclusive impede que um thread de chamada de nível passivo seja impedido por um APC enquanto o thread mantém um recurso compartilhado que o APC pode tentar acessar.

O thread de chamada deve permanecer na região crítica e manter o recurso especificado por não mais do que o necessário. Para liberar o recurso especificado e deixar a região crítica, chame a rotina ExReleaseResourceAndLeaveCriticalRegion .

Para obter mais informações sobre como usar uma estrutura ERESOURCE para sincronizar o acesso exclusivo a um recurso, consulte Introdução às rotinas ERESOURCE. Para obter mais informações sobre como inserir e sair de uma região crítica, consulte Regiões críticas e regiões protegidas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2003 SP1
Cabeçalho	wdm.h
IRQL	<= APC_LEVEL
Regras de conformidade da DDI	CriticalRegions(wdm), HwStorPortProhibitedDIs(storport)