Macro WppRecorderLogCreate (wpprecorder.h)
El método WppRecorderLogCreate crea un búfer para contener el registro de la grabadora.
Sintaxis
__drv_maxIRQL(DISPATCH_LEVEL)
NTSTATUS WppRecorderLogCreate(
[In] PRECORDER_LOG_CREATE_PARAMS CreateParams,
[Out] RECORDER_LOG * RecorderLog
);
Parámetros
[in] CreateParams
Puntero a una estructura de RECORDER_LOG_CREATE_PARAMS .
[out] RecorderLog
Identificador del registro de la grabadora.
Valor devuelto
None
Observaciones
Devuelve NTSTATUS que indica si el controlador puede usar el identificador RecorderLog para el registro.
Antes de llamar a WppRecorderLogCreate, asigne una estructura de RECORDER_LOG_CREATE_PARAMS e inicialice llamando a RECORDER_LOG_CREATE_PARAMS_INIT.
Primero debe llamar a WPP_INIT_TRACING antes de llamar a WppRecorderLogCreate. Los valores predeterminados se usan a menos que los miembros de CreateParams se modifiquen antes de llamar a WppRecorderLogCreate.
Si se devuelve un NTSTATUS correcto, el controlador puede usar el identificador RecorderLog para el registro.
Si no se devuelve un NTSTATUS correcto, el controlador debe usar un identificador de RECORDER_LOG en el registro predeterminado. Además, el controlador no debe intentar registrar ni eliminar el identificador al que apunta RecorderLog.
Nota
Este método asigna memoria para el búfer de registro del grupo no paginado.
Ejemplo
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 obtener más información sobre las marcas de tiempo en las entradas de registro de WPP, incluida la salida del registro de ejemplo, consulta Inflight Trace Recorder (IFR) para registrar seguimientos.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | wpprecorder.h |