Função ExAcquireSharedWaitForExclusive (wdm.h)

Artigo
08/08/2023

A rotina ExAcquireSharedWaitForExclusive adquire o recurso especificado para acesso compartilhado se o acesso compartilhado puder ser concedido e não houver garçons exclusivos.

Sintaxe

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

Parâmetros

[in, out] Resource

Um ponteiro para o recurso a ser adquirido para acesso compartilhado.

[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

ExAcquireSharedWaitForExclusive retornaráTRUE se o acesso solicitado for concedido ou um proprietário exclusivo liberar o recurso. Essa rotina retornará FALSE se a espera de entrada for FALSE e o acesso compartilhado não puder ser concedido imediatamente.

Comentários

A maioria dos drivers deve usar ExAcquireResourceSharedLite em vez de ExAcquireSharedWaitForExclusive.

O chamador pode liberar o recurso chamando ExReleaseResourceLite ou ExReleaseResourceForThreadLite.

Se o acesso compartilhado não puder ser concedido imediatamente, o chamador poderá aguardar que outros threads adquiram e liberem a propriedade exclusiva do recurso.

Se ou quando o chamador recebe acesso compartilhado ao recurso especificado depende do seguinte:

Se o recurso não for sem proprietário no momento, o acesso compartilhado será concedido imediatamente ao thread atual.
Se o chamador já tiver acesso exclusivo ao recurso, o thread atual receberá o mesmo tipo de acesso recursivamente.
Se o recurso pertencer atualmente como compartilhado e não houver nenhuma tentativa pendente de adquirir acesso exclusivo, o acesso compartilhado será concedido ao chamador imediatamente.
Se o recurso for atualmente propriedade como compartilhado, mas houver uma tentativa pendente de adquirir acesso exclusivo, o chamador será colocado em um estado de espera (Wait set como TRUE) ou ExAcquireSharedWaitForExclusive retornará FALSE.
Quando o thread atual aguarda para adquirir o recurso até que uma propriedade exclusiva pendente tenha sido lançada, ExAcquireSharedWaitForExclusive retorna TRUE quando o thread atual recebe acesso compartilhado ao recurso e retoma a execução.

O comportamento de ExAcquireSharedWaitForExclusive é idêntico ao de ExAcquireResourceSharedLite , a menos que o thread de chamada já possua o recurso como compartilhado e haja garçons exclusivos. Nesse caso, ExAcquireSharedWaitForExclusive permite que os garçons exclusivos adquiram propriedade exclusiva do recurso.

Se o chamador especificar TRUE para o parâmetro Wait , o chamador bloqueará até que outro thread libere o recurso em nome do chamador, usando ExReleaseResourceForThread. Os gravadores de driver devem ter cuidado para garantir que outro thread realmente libere o recurso; caso contrário, o chamador está em deadlock. ExAcquireResourceSharedLite não tem essa propriedade, portanto, os drivers devem usar essa rotina, a menos que exijam o comportamento específico de ExAcquireSharedWaitForExclusive.

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 reenabled chamando KeLeaveCriticalRegion. Para obter mais informações, consulte Desabilitando APCs.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlExApcLte3(wdm), SpNoWait(storport), WithinCriticalRegion(storport), WithinCriticalRegion(storport), WithinCriticalRegion(wdm)