Freigeben über


PCOMPLETE_LOCK_IRP_ROUTINE Rückruffunktion (ntifs.h)

Ein Dateisystemfiltertreiber (Legacyfilter) kann eine PCOMPLETE_LOCK_IRP_ROUTINE-typed-Routine als CompleteLockIrpRoutine Rückruf des Filters registrieren.

Syntax

PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;

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

Parameter

Context

[in] Kontextzeiger, der an FsRtlProcessFileLockübergeben wurde.

Irp

[in] IRP für die Dateisperre IRP_MJ_LOCK_CONTROL Anforderung, die abgeschlossen wird. Der Typ der Sperranforderung ist einer der folgenden:

  • IRP_MN_LOCK
  • IRP_MN_UNLOCK_ALL
  • IRP_MN_UNLOCK_ALL_BY_KEY
  • IRP_MN_UNLOCK_SINGLE

Rückgabewert

Diese Routine gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück. Wenn ein NTSTATUS-Wert zurückgegeben wird, der kein Erfolgscode ist, wird die Dateisperre aus der Datei entfernt.

Bemerkungen

Ein Dateisystemfiltertreiber (Legacyfilter) kann optional eine PCOMPLETE_LOCK_IRP_ROUTINE typierte Routine als CompleteLockIrpRoutine-Routine für eine Bytebereich-Dateisperre angeben.

Um diese Routine anzugeben, übergibt ein Legacyfilter einen Zeiger als CompleteLockIrpRoutine Parameter für FsRtlAllocateFileLock oder FsRtlInitializeFileLock.

Wenn der Legacyfilter eine CompleteLockIrpRoutine Routine für eine Dateisperre angibt, ruft das System diese Routine beim Abschließen eines IRP_MJ_LOCK_CONTROL Vorgangs für die Dateisperre auf.

Anforderungen

Anforderung Wert
Header- ntifs.h
IRQL- APC_LEVEL

Siehe auch

FsRtlAllocateFileLock

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFreeFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock-

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE