Macro TraceLoggingKeyword (traceloggingprovider.h)

  • Artículo

Macro contenedora traceLogging que establece la palabra clave para el evento.

Sintaxis

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Parámetros

[in] eventKeyword

Máscara de bits de 64 bits usada para indicar la pertenencia de un evento en un conjunto de categorías de eventos. Este valor debe ser una constante en tiempo de compilación.

Importante

ProviderId, Level y Keyword son los medios principales para filtrar eventos. Otros tipos de filtrado son posibles, pero tienen una sobrecarga mucho mayor. Asigne siempre una palabra clave y un nivel distinto de cero significativos a cada evento.

Consulte EVENT_DESCRIPTOR para obtener más información sobre la palabra clave event.

Valor devuelto

None

Observaciones

TraceLoggingKeyword(eventKeyword) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite para establecer la palabra clave del evento. La palabra clave Event es un medio principal para filtrar eventos. Asigne siempre una palabra clave significativa (distinta de cero) a cada evento.

Si no se proporcionan macros TraceLoggingKeyword a una llamada TraceLoggingWrite , la palabra clave predeterminada del evento es 0. Si se proporcionan varias macros TraceLoggingKeyword , los valores se agrupan juntos.

Microsoft define los 16 bits principales de la palabra clave (máscara de bits 0xFFFF000000000000). El proveedor de eventos define los 48 bits bajos de la palabra clave (máscara de bits 0x0000FFFFFFFFFFFF). Por ejemplo, el proveedor de eventos podría definir el bit 0 (máscara de bits 0x1) para que sea la categoría "E/S", bit 1 (máscara de bits 0x2) para que sea la categoría "UI" y bit 2 (máscara de bits 0x4) para que sea la categoría "medición de rendimiento". En este escenario, un evento podría tener su palabra clave establecida en 0x5, lo que indica que el evento está en las categorías "E/S" y "medición de rendimiento".

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado traceloggingprovider.h

Consulte también

EVENT_DESCRIPTOR

TraceLoggingWrite

Macros contenedoras de TraceLogging