Макрос WppRecorderLogCreate (wpprecorder.h)

Статья
02/07/2025

Метод WppRecorderLogCreate создает буфер для хранения журнала записи.

Синтаксис

__drv_maxIRQL(DISPATCH_LEVEL)
NTSTATUS WppRecorderLogCreate(
    [In]        PRECORDER_LOG_CREATE_PARAMS CreateParams,
    [Out]       RECORDER_LOG *              RecorderLog
    );

Параметры

[in] CreateParams

Указатель на структуру RECORDER_LOG_CREATE_PARAMS.

[out] RecorderLog

Дескриптор журнала записи.

Возвращаемое значение

Никакой

Замечания

Возвращает NTSTATUS, указывающее, может ли драйвер использовать дескриптор RecorderLog для ведения журнала.

Перед вызовом WppRecorderLogCreateвыделите структуру RECORDER_LOG_CREATE_PARAMS и инициализируйте путем вызова RECORDER_LOG_CREATE_PARAMS_INIT.

Перед вызовом WppRecorderLogCreate необходимо сначала вызвать WPP_INIT_TRACING. Значения по умолчанию используются, если только члены CreateParams изменяются перед вызовом WppRecorderLogCreate.

Если возвращается успешное значение NTSTATUS, драйвер может использовать дескриптор RecorderLog для ведения журнала.

Если успешный NTSTATUS не возвращается, драйвер должен использовать RECORDER_LOG дескриптор журнала по умолчанию. Кроме того, драйвер не должен пытаться войти в систему или удалить дескриптор, на который указывает RecorderLog.

Заметка

Этот метод выделяет память для буфера журнала из нестраничного пула.

Пример

RECORDER_LOG_CREATE_PARAMS  recorderCreate; 
RECORDER_LOG                logHandle;
 
RECORDER_LOG_CREATE_PARAMS_INIT(&recorderCreate, "Log #1");
recorderCreate.TotalBufferSize = 1024 * 8;
// Optionally use the following line to get timestamps in WPP log entries
recorderCreate.UseTimeStamp    = WppRecorderTrue;
// Use this line if you would like more precise timestamps (ten millionths of a second). This is valid only if you have set UseTimeStamp = WppRecorderTrue.
// recorderCreate.PreciseTimeStamp = WppRecorderTrue
status = WppRecorderLogCreate(&recorderCreate, &logHandle);

Дополнительные сведения о метках времени в записях журнала WPP, включая пример выходных данных журнала, см. в разделе Inflight Trace Recorder (IFR) для трассировки журналов.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	wpprecorder.h

См. также

структура RECORDER_LOG_CREATE_PARAMS

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