ProcessTraceBufferIncrementReference 함수(evntrace.h)

제공된 버퍼에서 BufferCallback 호출되어 호출자가 완료될 때까지 해제되지 않도록 합니다.

통사론

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

매개 변수

TraceHandle

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

Buffer

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

반환 값

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

발언

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

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

ProcessTraceBufferIncrementReferenceOpenTraceFromBufferStream열린 처리 세션에서 제공하는 버퍼에는 지원되지 않습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 11 2022 업데이트
지원되는 최소 서버	Windows Server 2022
대상 플랫폼	Windows
헤더	evntrace.h
라이브러리	Advapi32.dll
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