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.

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

Confira também

estrutura RECORDER_LOG_CREATE_PARAMS