Funzione FltAcquirePushLockExclusive (fltkernel.h)

Articolo
02/27/2024

La macro FltAcquirePushLockExclusive acquisisce il blocco push specificato per l'accesso esclusivo dal thread chiamante.

Sintassi

VOID FLTAPI FltAcquirePushLockExclusive(
  [in, out] PEX_PUSH_LOCK PushLock
);

Parametri

[in, out] PushLock

Puntatore di blocco push opaco di tipo PEX_PUSH_LOCK. Questo puntatore deve essere stato inizializzato da una chiamata precedente a FltInitializePushLock.

Valore restituito

No.

Osservazioni

FltAcquirePushLockExclusive acquisisce il blocco push specificato per l'accesso esclusivo dal thread chiamante.

I blocchi push sono simili alle strutture ERESOURCE (dette anche risorse) in quanto possono essere acquisiti per l'accesso condiviso o esclusivo. Per altre informazioni sui blocchi push, vedere la voce di riferimento per FltInitializePushLock.

A differenza delle strutture ERESOURCE, i blocchi push non possono essere acquisiti in modo ricorsivo. Se il chiamante ha già acquisito il blocco push per l'accesso esclusivo o condiviso, il thread verrà bloccato.

Quando il chiamante riceverà l'accesso esclusivo al blocco push specificato dipende dagli elementi seguenti:

Se il blocco push non viene attualmente generato, l'accesso esclusivo viene concesso immediatamente al thread corrente.
Se il blocco push è già stato acquisito per l'accesso esclusivo o condiviso da un altro thread, il thread corrente viene inserito in uno stato di attesa fino a quando non sarà possibile acquisire il blocco push.

Poiché FltAcquirePushLockExclusive disabilita il normale recapito APC del kernel, non è necessario chiamare KeEnterCriticalRegion o FsRtlEnterFileSystem prima di chiamare FltAcquirePushLockExclusive.

Per rilasciare il blocco push dopo l'acquisizione, chiama FltReleasePushLock. Ogni chiamata a FltAcquirePushLockExclusive deve corrispondere a una chiamata successiva a FltReleasePushLock.

Per acquisire un blocco push per l'accesso condiviso, chiamare FltAcquirePushLockShared.

Per inizializzare un blocco push, chiamare FltInitializePushLock.

Per eliminare un blocco push, chiamare FltDeletePushLock.