Macro TraceLoggingBinary (traceloggingprovider.h)

  • Artigo

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

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho traceloggingprovider.h

Confira também

TraceLoggingWrite

Macros de wrapper traceLogging