PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE funzione di callback (fltkernel.h)

Articolo
12/21/2024

Un driver minifilter può registrare una routine di tipo PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE come routine del driver minifilter CompleteLockCallbackDataRoutine routine di callback per una struttura FILE_LOCK.

Sintassi

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

NTSTATUS PfltCompleteLockCallbackDataRoutine(
  [in, optional] PVOID Context,
  [in]           PFLT_CALLBACK_DATA CallbackData
)
{...}

Parametri

[in, optional] Context

Puntatore di contesto passato a FltProcessFileLock.

[in] CallbackData

Puntatore alla struttura dei dati di callback (FLT_CALLBACK_DATA) per l'operazione di IRP_MJ_LOCK_CONTROL 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 minifiltro può facoltativamente specificare una routine di tipo PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE come CompleteLockCallbackDataRoutine routine per un blocco di file di intervallo di byte. Per specificare questa routine, il driver minifilter passa un puntatore alla routine come CompleteLockCallbackDataRoutine parametro per FltAllocateFileLock.

Quando si completa un'operazione di IRP_MJ_LOCK_CONTROL per il blocco file, gestione filtri chiama questa routine, se specificata, come notifica al minifiltro.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP SP2
server minimo supportato	Windows Server 2003 SP1
piattaforma di destinazione	Desktop
intestazione	fltkernel.h (include Fltkernel.h)
IRQL	<=APC_LEVEL