Функция 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, используемый для идентификации этого сеанса обработки. Обычно передается в ProcessTrace, чтобы начать обработку и CloseTrace для завершения обработки.

Замечания

Ожидается, что вызывающий объект предоставляет данные для трассировки путем вызова ProcessTraceAddBufferToBufferStream. Обычно это используется для удаленной обработки трассировки в режиме реального времени: удаленная система использует OpenTraceFromRealTimeLogger и ProcessTrace с BufferCallback, которая отправляет буферы по сети в локальную систему, затем локальная система вызывает OpenTraceFromBufferStream и ProcessTrace, получает буферы из сети и передает их локальному обработчику трассировки с помощью ProcessTraceAddBufferToBufferStream.

Этот режим обработки требует, чтобы буферы были предоставлены в том же порядке, что буферы были получены из ProcessTrace (например, первый буфер содержит сведения о заголовке и последующие буферы упорядочивается по времени очистки). Единственным поддерживаемым средством создания буферов таким образом является bufferCallback из другого OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions.

Требования