Compartilhar via


Macro ExAcquirePushLockExclusive (wdm.h)

Adquire o bloqueio de push determinado para acesso exclusivo pelo thread de chamada.

Sintaxe

void ExAcquirePushLockExclusive(
   Lock
);

Parâmetros

Lock

Ponteiro de bloqueio de push opaco. Esse ponteiro deve ter sido inicializado por uma chamada anterior para ExInitializePushLock.

Valor de retorno

Nenhum

Observações

Os bloqueios por push são semelhantes às estruturas ERESOURCE (também chamados de recursos) na medida em que podem ser adquiridos para acesso compartilhado ou exclusivo. Para obter mais informações sobre bloqueios por push, consulte a entrada de referência para ExInitializePushLock.

Ao contrário das estruturas ERESOURCE, os bloqueios de push não podem ser adquiridos recursivamente. Se o chamador já tiver adquirido o bloqueio por push para acesso exclusivo ou compartilhado, o thread será travado. Quando o chamador recebe acesso exclusivo ao bloqueio de push especificado, depende do seguinte:

  • Se o bloqueio por push não for semeado no momento, o acesso exclusivo será concedido imediatamente ao thread atual.

  • Se o bloqueio por push já tiver sido adquirido para acesso exclusivo ou compartilhado por outro thread, o thread atual será colocado em um estado de espera até que o bloqueio por push possa ser adquirido.

Antes de chamar essa rotina, o driver deve desabilitar a entrega normal do Kernel APC chamando KeEnterCriticalRegion. Entrega reencável depois que o bloqueio por push é liberado chamando KeLeaveCriticalRegion. Para obter mais informações, consulte Desabilitando APCs.

Para liberar o bloqueio por push depois de adquirido, chame ExReleasePushLockExclusive. Cada chamada para ExAcquirePushLockExclusive deve ser correspondida por uma chamada subsequente para exReleasePushLockExclusive.

Para adquirir um bloqueio por push para acesso compartilhado, chame ExAcquirePushLockShared .

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1809
cabeçalho wdm.h

Consulte também

ExInitializePushLock

KeEnterCriticalRegion

ExReleasePushLockExclusive

ExAcquirePushLockShared