PCOMPLETE_LOCK_IRP_ROUTINE funzione di callback (ntifs.h)

Articolo
03/05/2024

Un driver di filtro del file system (filtro legacy) può registrare una routine tipizzata PCOMPLETE_LOCK_IRP_ROUTINE come callback CompleteLockIrpRoutine del filtro.

Sintassi

PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;

NTSTATUS PcompleteLockIrpRoutine(
  PVOID Context,
  PIRP Irp
)
{...}

Parametri

Context

[in] Puntatore di contesto passato a FsRtlProcessFileLock.

Irp

[in] IRP per il blocco del file IRP_MJ_LOCK_CONTROL richiesta che viene completata. Il tipo di richiesta di blocco sarà uno dei seguenti:

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

Valore restituito

Questa routine restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato. Se restituisce un valore NTSTATUS che non è un codice riuscito, il blocco del file viene rimosso dal file.

Commenti

Un driver di filtro del file system (filtro legacy) può facoltativamente specificare una routine tipizzata di PCOMPLETE_LOCK_IRP_ROUTINE come routine del filtro legacy CompleteLockIrpRoutine per un blocco di file di intervallo di byte.

Per specificare questa routine, un filtro legacy passa un puntatore alla routine come parametro CompleteLockIrpRoutine per FsRtlAllocateFileLock o FsRtlInitializeFileLock.

Se il filtro legacy specifica una routine CompleteLockIrpRoutine per un blocco di file, il sistema chiama questa routine durante il completamento di un'operazione di IRP_MJ_LOCK_CONTROL per il blocco del file.