PfSetLogBuffer

[PfSetLogBuffer is available for use in the operating systems listed in the Requirements section. In Windows Server "Longhorn", this function returns ERROR_CALL_NOT_SUPPORTED. The MprConfigInterfaceTransportSetInfo function and the Windows Filtering Platform API Management Functions provide similar functionality.]

The PfSetLogBuffer function exchanges the log's current buffer for a new one.

DWORD PfSetLogBuffer(
  PBYTE pbBuffer,
  DWORD dwSize,
  DWORD dwThreshold,
  DWORD dwEntries,
  PDWORD pdwLoggedEntries,
  PDWORD pdwLostEntries,
  PDWORD pdwSizeUsed
);

Parameters

• pbBuffer
  [in] Pointer to the new log buffer. This buffer must be quad-word aligned.
• dwSize
  [in] Specifies the size, in bytes, of the new buffer.
• dwThreshold
  [in] Specifies the number of bytes used before signaling the event object associated with the log.
• dwEntries
  [in] Specifies the number of entries in the log that cause the event object to be signaled.
• pdwLoggedEntries
  [out] Pointer to a DWORD variable that receives the number of entries in the old buffer.
• pdwLostEntries
  [out] Pointer to a DWORD variable that receives the number of entries that could not be put into the old buffer.
• pdwSizeUsed
  [out] Pointer to a DWORD variable that receives the number of bytes used in the old buffer.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Requirements

See Also

PfMakeLog
PfDeleteLog