Função ExAcquireResourceExclusiveLite (wdm.h)

Artigo
08/08/2023

A rotina ExAcquireResourceExclusiveLite adquire o recurso fornecido para acesso exclusivo pelo thread de chamada.

Sintaxe

BOOLEAN ExAcquireResourceExclusiveLite(
  [in, out] PERESOURCE Resource,
  [in]      BOOLEAN    Wait
);

Parâmetros

[in, out] Resource

Um ponteiro para o recurso a ser adquirido.

[in] Wait

Especifica o comportamento da rotina sempre que o recurso não pode ser adquirido imediatamente. Se TRUE, o chamador será colocado em um estado de espera até que o recurso possa ser adquirido. Se FALSE, a rotina retornará imediatamente, independentemente de o recurso poder ser adquirido.

Retornar valor

ExAcquireResourceExclusiveLite retornará TRUE se o recurso for adquirido. Essa rotina retornará FALSE se a espera de entrada for FALSE e o acesso exclusivo não puder ser concedido imediatamente.

Comentários

A lista a seguir descreve se e quando um chamador recebe acesso exclusivo a um determinado recurso:

Se o recurso não pertencer no momento, o acesso exclusivo será concedido imediatamente ao thread atual.
Se o chamador já tiver adquirido o recurso para acesso exclusivo, o thread atual receberá o mesmo tipo de acesso recursivamente.-
Se o chamador tiver acesso compartilhado ao recurso, o chamador deverá liberar o bloqueio antes de tentar requisitar exclusivamente.
Se o recurso pertencer atualmente como exclusivo por outro thread ou se o chamador tiver acesso compartilhado apenas ao recurso, o thread atual será colocado em um estado de espera até que o recurso possa ser adquirido.

Se dois threads mantiverem um bloqueio compartilhado no mesmo recurso e tentarem adquirir o bloqueio exclusivamente sem liberar o bloqueio compartilhado, eles terão um deadlock. Isso significa que cada thread aguardará que o outro libere sua retenção compartilhada no bloqueio e nenhum deles liberará sua retenção compartilhada até que o outro o faça.

O chamador pode liberar o recurso chamando ExReleaseResourceLite ou ExReleaseResourceForThreadLite.

A entrega normal de APC do kernel deve ser desabilitada antes de chamar essa rotina. Desabilite a entrega normal de APC do kernel chamando KeEnterCriticalRegion. A entrega deve permanecer desabilitada até que o recurso seja liberado, momento em que ele pode ser reabilitado chamando KeLeaveCriticalRegion. Para obter mais informações, consulte Desabilitando APCs.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL
Regras de conformidade da DDI	ExclusiveResourceAccess(wdm), HwStorPortProhibitedDIs(storport), IrqlExApcLte3(wdm), WithinCriticalRegion(storport), WithinCriticalRegion(storport), WithinCriticalRegion(wdm)