ProcessTraceBufferIncrementReference 함수(evntrace.h)

제공된 버퍼에서 BufferCallback 중에 호출되어 호출자가 이를 수행할 때까지 해제되지 않도록 합니다.

구문

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceBufferIncrementReference(
  TRACEHANDLE             TraceHandle,
  const ETW_BUFFER_HEADER *Buffer
);

매개 변수

TraceHandle

이 버퍼 가 제공된 처리 세션입니다.

Buffer

참조할 버퍼입니다. 이 버퍼는 PETW_BUFFER_CALLBACK 콜백을 호출하여 가져와야 합니다.

반환 값

Win32 오류 코드입니다. 가능한 코드에는 ERROR_INVALID_PARAMETER 및 ERROR_OUTOFMEMORY 포함될 수 있습니다.

설명

PETW_BUFFER_CALLBACK 동안 Buffer에서 ProcessTraceBufferIncrementReference가 호출되지 않으면 PETW_BUFFER_CALLBACK 반환된 후 메모리에 더 이상 액세스할 수 없습니다.

호출자는 버퍼가 완료되면 버퍼에서 ProcessTraceBufferDecrementReference 를 호출합니다. 증분된 모든 버퍼에 대해 이 작업이 완료될 때까지 ProcessTrace가 반환되지 않습니다.

ProcessTraceBufferIncrementReference 는 OpenTraceFromBufferStream에서 연 처리 세션에서 제공하는 버퍼에 대해 지원되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	evntrace.h
라이브러리	Windows 8.1 및 Windows Server 2012 R2의 Sechost.lib; Advapi32.lib on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP
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