Функция ProcessTraceBufferIncrementReference (evntrace.h)

Статья
07/19/2024

Вызывается во время 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.

Замечания

Если ProcessTraceBufferIncrementReference не вызывается в буфере во время PETW_BUFFER_CALLBACK то память больше не доступна после возврата PETW_BUFFER_CALLBACK.

Вызывающий объект отвечает за вызов ProcessTraceBufferDecrementReference в буфере после их завершения. ProcessTrace не возвращается до тех пор, пока это не будет сделано для каждого буфера, который был добавлен.

ProcessTraceBufferIncrementReference не поддерживается для буферов, предоставляемых сеансом обработки, открытым OpenTraceFromBufferStream.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Обновление Windows 11 2022
минимальный поддерживаемый сервер	Windows Server 2022
целевая платформа	Виндоус
заголовка	evntrace.h
библиотеки	Advapi32.dll
DLL	Sechost.dll в Windows 8.1 и Windows Server 2012 R2; Advapi32.dll в Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista и Windows XP

Поделиться через