ClfsLogGrowthCompleteCallback function

The ClfsLogGrowthCompleteCallback function implements the actions that the client will take when space is freed in a log that had previously been full.


  _In_ NTSTATUS         OperationStatus,
  _In_ BOOLEAN          LogIsPinned,
  _In_ PVOID            ClientData


LogFile [in]

A pointer to a LOG_FILE_OBJECT structure that represents the CLFS log stream whose log has finished growing.

OperationStatus [in]

The status of the client's earlier request to handle a log file full condition. This will be either STATUS_SUCCESS or an error status that indicates the reason that the request could not be completed successfully.

LogIsPinned [in]

If TRUE, specifies that the log tail is currently pinned; FALSE if the log tail is not pinned.

ClientData [in]

A pointer to client-supplied information.

Return value



Because a call to ClfsMgmtHandleLogFileFull completes asynchronously, any actions that the client will take when the log file full condition has been handled belong in the ClfsLogGrowthCompleteCallback function.

If a call to the ClfsMgmtHandleLogFileFull routine returned returns STATUS_PENDING, then the ClfsLogGrowthCompleteCallback function will be invoked when the operation completes. If a different status was returned, then the ClfsLogGrowthCompleteCallback function will not be invoked.

The ClfsLogGrowthCompleteCallback function should only perform a minimal amount of processing before returning. For example, the ClfsLogGrowthCompleteCallback function might follow the following procedure:

  1. If the value of the OperationStatus parameter is an error status, return.

  2. If the value of the OperationStatus parameter is STATUS_SUCCESS, create and queue a work item to inform the client that it can resume processing.

When a client uses the ClfsMgmtRegisterManagedClient routine to register with CLFS management, the client provides both a pointer to the ClfsLogGrowthCompleteCallback function and the custom data that will be passed as a parameter to the ClfsLogGrowthCompleteCallback function when this function is called.


Target platform


Supported in Windows Server 2003 R2, Windows Vista, and later versions of Windows.


Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)


Called at IRQL <= APC_LEVEL

See also




Send comments about this topic to Microsoft

© 2016 Microsoft