Macro TraceLoggingBinary (traceloggingprovider.h)

  • Artículo

Macro contenedora traceLogging que agrega un campo con datos binarios al evento.

Sintaxis

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Parámetros

[in] pValue

Puntero a los datos que se van a incluir en el evento .

[in] cbValue

Tamaño, en bytes, de los datos que se van a incluir en el evento .

[in, optional] __VA_ARGS__

Parámetros de nombre, descripción y etiquetas opcionales para la definición de campo.

TraceLoggingBinary se puede especificar con 2, 3, 4 o 5 parámetros. Si no se especifica un parámetro opcional, se usará un valor predeterminado. Por ejemplo, TraceLoggingBinary(&x.data, sizeof(x.data)) es equivalente a TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

  • [in, optional] name

    Nombre que se va a usar para el campo de evento. Si se proporciona, el parámetro name debe ser un literal de cadena (no una variable) y no debe contener caracteres '\0'. Si no se proporciona, el nombre del campo de evento se basará en pValue.

  • [in, optional] description

    Descripción del valor del campo de evento. Si se proporciona, el parámetro description debe ser un literal de cadena y se incluirá en la PDB.

  • [in, optional] tags

    Valor entero constante en tiempo de compilación. Los 28 bits inferiores del valor se incluirán en los metadatos del campo. El consumidor de eventos define la semántica de este valor. Durante el procesamiento de eventos, este valor se puede recuperar del campo Etiquetas de EVENT_PROPERTY_INFO .

Valor devuelto

None

Observaciones

TraceLoggingBinary(pValue, cbValue, ...) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite . Cada parámetro TraceLoggingBinary agrega un campo al evento.

Requisitos

   
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

TraceLoggingWrite

Macros contenedoras traceLogging