enumeración TDH_CONTEXT_TYPE (tdh.h)

  • Artículo

Define el 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
Cadena Unicode terminada en NULL que contiene el nombre del archivo .tmf utilizado para analizar el registro de WPP. Normalmente, el nombre del archivo .tmf se selecciona del GUID del evento, por lo que no es necesario especificar el nombre de archivo.
TDH_CONTEXT_WPP_TMFSEARCHPATH
Cadena Unicode terminada en NULL que contiene la ruta de acceso al archivo .tmf. No es necesario especificar esta ruta de acceso si la ruta de acceso de búsqueda contiene el archivo. Especifique solo esta información de contexto si también especifica el tipo de contexto TDH_CONTEXT_WPP_TMFFILE. Si no se encuentra el archivo, TDH busca en las siguientes ubicaciones en el orden especificado:


  • Ruta de acceso especificada en la variable de entorno TRACE_FORMAT_SEARCH_PATH

  • La carpeta actual
TDH_CONTEXT_WPP_GMT
Marca booleana de 1 byte que indica si la marca de tiempo del evento WPP se debe convertir en coordenada de hora universal (UTC). Si es 1, la marca de tiempo se convierte en UTC. Si es 0, la marca de tiempo se encuentra en la hora local. De forma predeterminada, la marca de tiempo está en la hora local.
TDH_CONTEXT_POINTERSIZE
Tamaño, en bytes, de los tipos de datos de puntero o size_t tipos de datos usados en el evento. Indica si el evento usó valores de 4 bytes o 8 bytes. De forma predeterminada, el tamaño del puntero es el tamaño del puntero del equipo de descodificación.

Para determinar el tamaño del puntero o size_t valor, use el miembro PointerSize de TRACE_LOGFILE_HEADER (el primer evento que recibe en la devolución de llamada EventRecordCallback contiene este encabezado en la sección de datos). Sin embargo, este valor puede no ser preciso. Por ejemplo, en un equipo de 64 bits, una aplicación de 32 bits registrará punteros de 4 bytes; sin embargo, la sesión establecerá PointerSize en 8.
TDH_CONTEXT_PDB_PATH
Cadena Unicode terminada en NULL que contiene el nombre del archivo .pdb para el binario que contiene mensajes WPP. Este parámetro se puede usar como alternativa a TDH_CONTEXT_WPP_TMFFILE o TDH_CONTEXT_WPP_TMFSEARCHPATH.

Nota Solo está disponible para Windows 8 y Windows Server 2012.

 
TDH_CONTEXT_MAXIMUM
Reservado.

Comentarios

Si va a especificar información de contexto para un evento ETW heredado, solo tiene que especificar el tipo de TDH_CONTEXT_POINTERSIZE, los demás tipos se usan para los eventos WPP y se omiten para los eventos ETW heredados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado tdh.h

Consulte también

TDH_CONTEXT