Macro TraceLoggingBinary (traceloggingprovider.h)

Macro wrapper traceLogging que adiciona um campo com dados binários ao evento.

Sintaxe

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

Parâmetros

[in] pValue

Um ponteiro para os dados a serem incluídos no evento.

[in] cbValue

O tamanho, em bytes, dos dados a serem incluídos no evento.

[in, optional] __VA_ARGS__

Parâmetros opcionais de nome, descrição e marcas para a definição de campo.

TraceLoggingBinary pode ser especificado com 2, 3, 4 ou 5 parâmetros. Se um parâmetro opcional não for especificado, um padrão será usado. Por exemplo, TraceLoggingBinary(&x.data, sizeof(x.data)) é equivalente a TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

• [in, optional] name

  O nome a ser usado para o campo de evento. Se fornecido, o parâmetro name deve ser um literal de cadeia de caracteres (não uma variável) e não deve conter nenhum caractere '\0'. Se não for fornecido, o nome do campo de evento será baseado em pValue.

• [in, optional] description

  A descrição do valor do campo de evento. Se fornecido, o parâmetro de descrição deve ser um literal de cadeia de caracteres e será incluído no PDB.

• [in, optional] tags

  Um valor inteiro constante de tempo de compilação. Os 28 bits baixos do valor serão incluídos nos metadados do campo. A semântica desse valor é definida pelo consumidor do evento. Durante o processamento de eventos, esse valor pode ser recuperado do campo Marcas de EVENT_PROPERTY_INFO .

Valor retornado

Nenhum

Comentários

TraceLoggingBinary(pValue, cbValue, ...) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite . Cada parâmetro TraceLoggingBinary adiciona um campo ao evento.

Requisitos

Confira também

TraceLoggingWrite

Macros de wrapper traceLogging