Función EtwWriteString (wdm.h)
La función EventWriteString es una función de seguimiento que se puede usar cuando no se requieren datos sofisticados. Esta función es similar a una instrucción de impresión de depuración.
Sintaxis
NTSTATUS EtwWriteString(
[in] REGHANDLE RegHandle,
[in] UCHAR Level,
[in] ULONGLONG Keyword,
[in, optional] LPCGUID ActivityId,
[in] PCWSTR String
);
Parámetros
[in] RegHandle
Puntero al identificador de registro del proveedor de eventos, que devuelve la función EtwRegister si el registro del proveedor de eventos es correcto.
[in] Level
Nivel en el que está activo el evento.
[in] Keyword
Palabra clave del evento. Una palabra clave es una máscara de bits que realiza instrucciones generales sobre la categoría del evento o error. Dado que la palabra clave es una máscara de bits, puede aplicar más de una palabra clave a un único evento. Puede definir las palabras clave y las posiciones de bits, o bien usar palabras clave estándar de Windows, o bien puede usar la combinación de sus propias palabras clave y las palabras clave de Windows.
[in, optional] ActivityId
Identificador que indica la actividad asociada al evento. ActivityId proporciona una manera de agrupar eventos relacionados y se usa en el seguimiento de un extremo a otro. Este identificador es opcional y puede ser NULL.
[in] String
Cadena terminada en null (WCHAR).
Valor devuelto
La función devuelve STATUS_SUCCESS si el evento se publica correctamente.
Comentarios
Dado que la cadena generada por la función EventWriteString no es localizable, esta función no se recomienda para su uso en el código de producción. Esta función no se debe usar para registrar eventos altamente visibles.
Puede llamar a EtwwriteString en cualquier IRQL. Sin embargo, cuando IRQL es mayor que APC_LEVEL, los datos pasados a las funciones EtwWrite, EtwwriteEx, EtwwriteString y EtwWriteTransfer no deben ser paginables. Es decir, cualquier rutina en modo kernel que se ejecuta en IRQL mayor que APC_LEVEL no puede acceder a la memoria paginable. Los datos pasados a las funciones Etwwrite, EtwwriteEx, EtwwriteString y EtwwriteTransfer deben residir en la memoria del espacio del sistema, independientemente de cuál sea el IRQL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | Cualquier nivel (consulte la sección Comentarios). |