PETW_BUFFER_CALLBACK 콜백 함수(evntrace.h)

ProcessTrace에서 호출할 BufferCallback에 대한 함수 정의입니다.

구문

PETW_BUFFER_CALLBACK PetwBufferCallback;

BOOL PetwBufferCallback(
  const ETW_BUFFER_HEADER *Buffer,
  ULONG BufferSize,
  const ETW_BUFFER_CALLBACK_INFORMATION *ConsumerInfo,
  void *CallbackContext
)
{...}

매개 변수

Buffer

원시 버퍼 데이터에 대한 포인터입니다. 이 데이터는 ETW_BUFFER_HEADER 구조체로 시작하고 그 뒤에 이벤트 데이터가 잇습니다.

기본적으로 이 버퍼는 콜백이 반환될 때까지만 사용할 수 있습니다. 콜백이 반환된 후 버퍼를 사용하려면 ProcessTraceBufferIncrementReference를 호출합니다. 그러면 프로세스TraceBufferDecrementReference 를 호출할 때까지 버퍼를 계속 사용할 수 있습니다.

ProcessTrace는 이러한 모든 버퍼 참조가 감소될 때까지 반환되지 않습니다.

BufferSize

제공된 버퍼의 크기입니다.

ConsumerInfo

처리 세션의 현재 상태에 대한 정보를 포함합니다.

CallbackContext

ETW_OPEN_TRACE_OPTIONS 사용자가 제공한 컨텍스트 입니다. BufferCallbackContext.

반환 값

TRUE이면 처리가 계속됩니다. FALSE이면 추적 처리가 중지되고 ProcessTrace가 반환됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	evntrace.h
라이브러리	Windows 8.1 및 Windows Server 2012 R2의 Sechost.lib; Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP의 Advapi32.lib
DLL	Windows 8.1 및 Windows Server 2012 R2의 Sechost.dll. Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP의 Advapi32.dll