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 |