Macro WppRecorderLogCreate (wpprecorder.h)

O método WppRecorderLogCreate cria um buffer para conter o log do gravador.

Sintaxe

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

Parâmetros

[in] CreateParams

Um ponteiro para uma estrutura de RECORDER_LOG_CREATE_PARAMS .

[out] RecorderLog

Um identificador para o log do gravador.

Retornar valor

Nenhum

Comentários

Retorna NTSTATUS que indica se o driver pode usar o identificador RecorderLog para registro em log.

Antes de chamar WppRecorderLogCreate, aloque uma estrutura de RECORDER_LOG_CREATE_PARAMS e inicialize chamando RECORDER_LOG_CREATE_PARAMS_INIT.

Primeiro, você deve chamar WPP_INIT_TRACING antes de chamar WppRecorderLogCreate. Os valores padrão são usados, a menos que os membros do CreateParams sejam modificados antes de chamar WppRecorderLogCreate.

Se um NTSTATUS bem-sucedido for retornado, o driver poderá usar o identificador RecorderLog para registro em log.

Se um NTSTATUS bem-sucedido não for retornado, o driver deverá usar um identificador RECORDER_LOG para o log padrão. Além disso, o driver não deve tentar fazer logon ou excluir o identificador apontado pelo RecorderLog.

Observação

Esse método aloca memória para o buffer de log do pool não paginado.

Exemplo

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);

Para obter mais informações sobre carimbos de data/hora em entradas de log do WPP, incluindo saída de log de exemplo, consulte IfR (Gravador de Rastreamento de Inflight) para registrar rastreamentos em log.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	wpprecorder.h

Confira também

estrutura RECORDER_LOG_CREATE_PARAMS