Export (0) Print
Expand All

ClfsLogUnpinnedCallback function

The ClfsLogUnpinnedCallback function implements any actions that the client will take when a log that had previously been pinned becomes unpinned.

Syntax


VOID (*PCLFS_CLIENT_LOG_UNPINNED_CALLBACK)(
  _In_  PLOG_FILE_OBJECT LogFile,
  _In_  PVOID ClientData
);

Parameters

LogFile [in]

A pointer to a LOG_FILE_OBJECT structure that represents the CLFS log stream whose tail has become unpinned.

ClientData [in]

A pointer to client-supplied information. You specify this data in the LogUnpinnedCallbackData member of the CLFS_MGMT_CLIENT_REGISTRATION structure.

Return value

None

Remarks

If a client called the ClfsMgmtHandleLogFileFull routine and CLFS management subsequently called the client's ClfsLogGrowthCompleteCallback function with a value of TRUE for the LogIsPinned parameter, then the ClfsLogUnpinnedCallback function will be invoked when the log becomes unpinned.

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

The ClfsLogUnpinnedCallback function should only perform a minimal amount of processing before returning. For example, it might create and queue a work item to inform the client that it can resume processing.

The ClfsLogGrowthCompleteCallback function is called before the ClfsLogUnpinnedCallback function.

Requirements

Version

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

Header

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

IRQL

Called at IRQL <= APC_LEVEL

See also

CLFS_MGMT_CLIENT_REGISTRATION
ClfsMgmtHandleLogFileFull

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft