Share via


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

Server Requires Windows Server 2003 or Windows 2000 Server.
Header

Declared in Fltdefs.h.

Library

Use Iphlpapi.lib.

DLL Requires Iphlpapi.dll.

See Also

PfMakeLog
PfDeleteLog