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 RECORDER_LOG_CREATE_PARAMS.
[out] RecorderLog
Um identificador para o log do gravador.
Valor de retorno
Nenhum
Observações
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.
Você deve primeiro 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 de RecorderLog para registro em log.
Se um NTSTATUS bem-sucedido não for retornado, o driver deverá usar um identificador de RECORDER_LOG para o log padrão. Além disso, o driver não deve tentar fazer logon ou excluir o identificador apontado por RecorderLog.
Nota
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.
Requisitos
Requisito | Valor |
---|---|
da Plataforma de Destino | Windows |
cabeçalho | wpprecorder.h |
Consulte também
estrutura RECORDER_LOG_CREATE_PARAMS