Función EtwWriteString (wdm.h)
La función EventWriteString es una función de seguimiento que 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 se realiza correctamente.
[in] Level
Nivel en el que está activo el evento.
[in] Keyword
Palabra clave para el 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 puede usar palabras clave estándar de Windows, o 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. El 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.
Observaciones
Dado que la cadena generada por EventWriteString función 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 muy visibles.
Puede llamar a etwriteString en cualquier IRQL. Sin embargo, cuando IRQL es mayor que APC_LEVEL, los datos pasados al etwrite de, EtwriteEx, EtwriteStringy etwriteTransfer 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 al etwrite de, EtwriteEx, etwriteStringy etwriteTransfer deben residir en la memoria del espacio del sistema, independientemente de lo que sea IRQL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | Cualquier nivel (consulte la sección Comentarios). |