Macro TraceLoggingBinary (traceloggingprovider.h)
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 |