enumeração TDH_CONTEXT_TYPE (tdh.h)

  • Artigo

Define o tipo de contexto.

Syntax

typedef enum _TDH_CONTEXT_TYPE {
  TDH_CONTEXT_WPP_TMFFILE,
  TDH_CONTEXT_WPP_TMFSEARCHPATH,
  TDH_CONTEXT_WPP_GMT,
  TDH_CONTEXT_POINTERSIZE,
  TDH_CONTEXT_PDB_PATH,
  TDH_CONTEXT_MAXIMUM
} TDH_CONTEXT_TYPE;

Constantes

 
TDH_CONTEXT_WPP_TMFFILE
Cadeia de caracteres Unicode terminada em nulo que contém o nome do arquivo .tmf usado para analisar o log do WPP. Normalmente, o nome do arquivo .tmf é obtido do GUID do evento para que você não precise especificar o nome do arquivo.
TDH_CONTEXT_WPP_TMFSEARCHPATH
Cadeia de caracteres Unicode terminada em nulo que contém o caminho para o arquivo .tmf. Você não precisará especificar esse caminho se o caminho de pesquisa contiver o arquivo. Especifique essas informações de contexto somente se você também especificar o tipo de contexto TDH_CONTEXT_WPP_TMFFILE. Se o arquivo não for encontrado, o TDH pesquisa os seguintes locais na ordem fornecida:


  • O caminho especificado na variável de ambiente TRACE_FORMAT_SEARCH_PATH

  • A pasta atual
TDH_CONTEXT_WPP_GMT
Um sinalizador booliano de 1 byte que indica se o carimbo de data/hora do evento WPP deve ser convertido em UTC (Coordenada de Tempo Universal). Se 1, o carimbo de data/hora será convertido em UTC. Se 0, o carimbo de data/hora será no horário local. Por padrão, o carimbo de data/hora está no horário local.
TDH_CONTEXT_POINTERSIZE
Tamanho, em bytes, dos tipos de dados de ponteiro ou size_t tipos de dados usados no evento. Indica se o evento usou valores de 4 bytes ou 8 bytes. Por padrão, o tamanho do ponteiro é o tamanho do ponteiro do computador de decodificação.

Para determinar o tamanho do ponteiro ou size_t valor, use o membro PointerSize do TRACE_LOGFILE_HEADER (o primeiro evento que você recebe no retorno de chamada EventRecordCallback contém esse cabeçalho na seção de dados). No entanto, esse valor pode não ser preciso. Por exemplo, em um computador de 64 bits, um aplicativo de 32 bits registrará ponteiros de 4 bytes; no entanto, a sessão definirá PointerSize como 8.
TDH_CONTEXT_PDB_PATH
Cadeia de caracteres Unicode terminada em nulo que contém o nome do arquivo .pdb para o binário que contém mensagens WPP. Esse parâmetro pode ser usado como uma alternativa para TDH_CONTEXT_WPP_TMFFILE ou TDH_CONTEXT_WPP_TMFSEARCHPATH.

Nota Disponível somente para Windows 8 e Windows Server 2012.

 
TDH_CONTEXT_MAXIMUM
Reservado.

Comentários

Se você estiver especificando informações de contexto para um evento ETW herdado, só precisará especificar o tipo TDH_CONTEXT_POINTERSIZE – os outros tipos são usados para eventos WPP e ignorados para eventos ETW herdados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho tdh.h

Confira também

TDH_CONTEXT