Función WmiTraceMessage (wdm.h)
La rutina WmiTraceMessage agrega un mensaje al registro de salida de una sesión de seguimiento de software de WPP .
Sintaxis
NTSTATUS WmiTraceMessage(
[in] TRACELOGGER_HANDLE LoggerHandle,
[in] ULONG MessageFlags,
[in] LPCGUID MessageGuid,
[in] USHORT MessageNumber,
...
);
Parámetros
[in] LoggerHandle
Especifica un identificador de seguimiento para una sesión de seguimiento de software.
[in] MessageFlags
Especifica un OR bit a bit de una o varias marcas de mensaje. Para obtener información detallada, consulte la sección Comentarios.
[in] MessageGuid
Especifica un GUID que identifica la clase de mensajes de seguimiento de software.
[in] MessageNumber
Identifica el subtipo de mensaje. El significado de los subtipos es específico de la clase de seguimiento de software y del proveedor.
[in] ...
Proporciona una lista necesaria de parámetros de mensaje que especifican un conjunto de elementos de mensaje. Los parámetros se organizan como una secuencia de pares de parámetros, donde cada par especifica una parte del mensaje completo. Cada par de parámetros consta de un puntero PVOID a los datos, seguido inmediatamente de un valor de ULONG que especifica la longitud de los datos. La lista de parámetros debe finalizarse mediante un puntero PVOID NULL seguido de un ULONG(0).
Valor devuelto
WmiTraceMessage devuelve uno de los siguientes valores:
Código devuelto | Descripción |
---|---|
|
La operación se ha completado correctamente. |
|
LoggerHandle no es un identificador de seguimiento de software válido. |
|
No hay suficiente memoria de búfer para registrar el mensaje. Consulte la sección Comentarios. |
|
Se ha producido un error interno. |
Comentarios
Un llamador puede usar WmiTraceMessage o WmiTraceMessageVa para agregar un mensaje al registro de salida de una sesión de seguimiento de software de WPP. WmiTraceMessage simplifica el código de un llamador controlando el mecanismo de lista de variables antes de llamar a WmiTraceMessageVa.
Un llamador puede establecer las siguientes marcas de mensaje:
Marca | Descripción |
---|---|
TRACE_MESSAGE_SEQUENCE | Incluya un número de secuencia en el mensaje. La secuenciación de mensajes solo se puede usar si se establece para la sesión de seguimiento de software especificada por LoggerHandle. |
TRACE_MESSAGE_GUID | MessageGuid especifica un GUID que identifica una clase de seguimiento de software. Esta marca debe establecerse. |
TRACE_MESSAGE_TIMESTAMP | Incluya una marca de tiempo en el mensaje. |
TRACE_MESSAGE_PERFORMANCE_TIMESTAMP | Esta marca no está implementada y está obsoleta. No se debe usar. |
TRACE_MESSAGE_SYSTEMINFO | Incluya el identificador de subproceso (TID) y el identificador de proceso (PID) en el mensaje. |
No se registrará un mensaje si se cumple una de las siguientes condiciones:
- El tamaño total, en bytes, de los datos del mensaje y el encabezado del mensaje es mayor que el tamaño de los búferes de mensajes individuales asignados para una sesión de seguimiento de software. (El tamaño máximo del encabezado del mensaje es de 48 bytes).
- Todos los búferes de mensajes asignados a la sesión de seguimiento de software están llenos.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de Windows. |
Plataforma de destino | Universal |
Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
Library | NtosKrnl.lib |
Archivo DLL | NtosKrnl.exe |
IRQL | vea la sección Comentarios. |