Função ExAcquireResourceSharedLite (wdm.h)
A rotina ExAcquireResourceSharedLite adquire o recurso determinado para acesso compartilhado pelo thread de chamada.
Sintaxe
BOOLEAN ExAcquireResourceSharedLite(
[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 VERDADEIRO, 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.
Valor de retorno
O chamador pode liberar o recurso chamando ExReleaseResourceLite ou ExReleaseResourceForThreadLite.
ExAcquireResourceSharedLite retorna VERDADEIRO se (ou quando) o recurso for adquirido. Essa rotina retornará FALSE se a de espera de de entrada for FALSE e o acesso compartilhado não puder ser concedido imediatamente.
Observações
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 adquirido o recurso (para acesso compartilhado ou exclusivo), o thread atual receberá o mesmo tipo de acesso recursivamente. Observe que fazer essa chamada não converte o acesso exclusivo de um chamador de um determinado recurso para acesso compartilhado.
Se o recurso for atualmente de propriedade como compartilhado por outro thread e nenhum thread estiver aguardando acesso exclusivo ao recurso, o acesso compartilhado será concedido ao chamador imediatamente. O chamador é colocado em um estado de espera se houver um garçom exclusivo.
Se o recurso atualmente pertencer como exclusivo por outro thread ou se houver outro thread aguardando acesso exclusivo e o chamador ainda não tiver acesso compartilhado ao recurso, o thread atual será colocado em um estado de espera (Wait definido como TRUE) ou ExAcquireResourceSharedLite retornará FALSE.
A entrega normal de APC do kernel deve ser desabilitada antes de chamar essa rotina. Desabilite a entrega normal do 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte3(wdm), WithinCriticalRegion(storport), WithinCriticalRegion(storport), WithinCriticalRegion(wdm) |
Consulte também
ExAcquireResourceExclusiveLite
ExAcquireSharedStarveExclusive
ExAcquireSharedWaitForExclusive
ExConvertExclusiveToSharedLite