Condividi tramite


PCOMPLETE_LOCK_IRP_ROUTINE funzione di callback (ntifs.h)

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

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 di 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.

Osservazioni

Un driver di filtro del file system (filtro legacy) può facoltativamente specificare una routine tipizzata di PCOMPLETE_LOCK_IRP_ROUTINE come routine completaLockIrpRoutine del filtro legacy routine 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 quando si completa un'operazione di IRP_MJ_LOCK_CONTROL per il blocco del file.

Fabbisogno

Requisito Valore
intestazione ntifs.h
IRQL APC_LEVEL

Vedere anche

FsRtlAllocateFileLock

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFreeFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE