PFLT_GET_OPERATION_STATUS_CALLBACK callback function (fltkernel.h)

Article
02/22/2024

A minifilter driver can register a routine of type PFLT_GET_OPERATION_STATUS_CALLBACK as the minifilter driver's OperationStatusCallback routine.

Syntax

PFLT_GET_OPERATION_STATUS_CALLBACK PfltGetOperationStatusCallback;

void PfltGetOperationStatusCallback(
  [in]           PCFLT_RELATED_OBJECTS FltObjects,
  [in]           PFLT_IO_PARAMETER_BLOCK IopbSnapshot,
  [in]           NTSTATUS OperationStatus,
  [in, optional] PVOID RequesterContext
)
{...}

Parameters

[in] FltObjects

A pointer to an FLT_RELATED_OBJECTS structure that contains opaque pointers for the objects related to the current operation.

[in] IopbSnapshot

A pointer to the data structure containing parameters from the IO Request Packet for the operation.

[in] OperationStatus

The NTSTATUS value of the I/O operation generating the callback.

[in, optional] RequesterContext

An optional pointer to a minifilter driver-provided context information of the requester passed from FltRequestOperationStatusCallback.

Return value

None

Remarks

A minifilter driver can register a routine of type PFLT_GET_OPERATION_STATUS_CALLBACK as the minifilter driver's OperationStatusCallback routine.

Most minifilter drivers never need to register a routine of type PFLT_GET_OPERATION_STATUS_CALLBACK. Normally, a minifilter driver only calls this routine to determine whether a requested opportunistic lock was granted.

Requirements

Requirement	Value
Minimum supported client	Available in Microsoft Windows 2000 Update Rollup 1 for SP4, Windows XP SP2, Windows Server 2003 SP1, and later operating systems. Not available in Windows 2000 SP4 and earlier operating systems.
Target Platform	Desktop
Header	fltkernel.h (include FltKernel.h)
IRQL	<= APC_LEVEL