OpenTraceFromBufferStream 함수(evntrace.h)

파일 또는 활성 세션에 직접 연결되지 않은 추적 처리 세션을 만듭니다.

통사론

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromBufferStream(
  const ETW_OPEN_TRACE_OPTIONS    *Options,
  PETW_BUFFER_COMPLETION_CALLBACK BufferCompletionCallback,
  void                            *BufferCompletionContext
);

매개 변수

Options

이 처리 세션에 대한 구성 옵션입니다. 자세한 내용은 ETW_OPEN_TRACE_OPTIONS 참조하세요.

BufferCompletionCallback

처리 세션이 ProcessTraceAddBufferToBufferStream전달된 버퍼로 완료되면 이 콜백을 호출하여 해당 버퍼에 필요할 수 있는 여유 또는 기타 정리를 허용합니다.

BufferCompletionContext

BufferCompletionCallback전달될 사용자 제공 컨텍스트입니다.

반환 값

이 처리 세션을 식별하는 데 사용되는 TRACEHANDLE입니다. 일반적으로 처리를 시작하고 CloseTrace 프로세스 추적 전달됩니다.

발언

호출자는 ProcessTraceAddBufferToBufferStream호출하여 추적에 대한 데이터를 제공해야 합니다. 이는 일반적으로 원격 실시간 추적 처리에 사용됩니다. 원격 시스템은 네트워크를 통해 버퍼를 로컬 시스템으로 보내는 BufferCallback OpenTraceFromRealTimeLogger 및 ProcessTrace 사용합니다. 그런 다음 로컬 시스템에서 OpenTraceFromBufferStream 호출하고 ProcessTrace네트워크에서 버퍼를 수신하고 ProcessTraceAddBufferToBufferStream사용하여 로컬 추적 프로세서에 공급합니다.

이 처리 모드에서는 ProcessTrace 버퍼를 받은 것과 동일한 순서로 버퍼를 제공해야 합니다(예: 첫 번째 버퍼에는 헤더 정보가 포함되고 후속 버퍼는 플러시 시간별로 정렬됨). 이러한 방식으로 버퍼를 생성하는 유일한 방법은 다른 OpenTraceFromBufferStream, OpenTraceFromFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions 처리 세션의 BufferCallback 것입니다.

요구 사항

요구	값
지원되는 최소 클라이언트	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