TDH_CONTEXT_TYPE-Enumeration (tdh.h)

  • Artikel

Definiert den Kontexttyp.

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;

Konstanten

 
TDH_CONTEXT_WPP_TMFFILE
Unicode-Zeichenfolge mit Null-Beendigung, die den Namen der TMF-Datei enthält, die für die Analyse des WPP-Protokolls verwendet wird. In der Regel wird der TMF-Dateiname aus der Ereignis-GUID abgerufen, sodass Sie den Dateinamen nicht angeben müssen.
TDH_CONTEXT_WPP_TMFSEARCHPATH
Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad zur TMF-Datei enthält. Sie müssen diesen Pfad nicht angeben, wenn der Suchpfad die Datei enthält. Geben Sie diese Kontextinformationen nur an, wenn Sie auch den TDH_CONTEXT_WPP_TMFFILE Kontexttyp angeben. Wenn die Datei nicht gefunden wird, durchsucht TDH die folgenden Speicherorte in der angegebenen Reihenfolge:


  • Der in der umgebungsvariablen TRACE_FORMAT_SEARCH_PATH angegebene Pfad

  • Der aktuelle Ordner
TDH_CONTEXT_WPP_GMT
Ein boolesches 1-Byte-Flag, das angibt, ob der WPP-Ereigniszeitstempel in Die Weltzeitkoordinate (UTC) konvertiert werden soll. Wenn 1, wird der Zeitstempel in UTC konvertiert. Wenn 0, befindet sich der Zeitstempel in der Ortszeit. Standardmäßig befindet sich der Zeitstempel in der Ortszeit.
TDH_CONTEXT_POINTERSIZE
Größe der Zeigerdatentypen in Bytes oder size_t Datentypen, die im Ereignis verwendet werden. Gibt an, ob das Ereignis 4-Byte- oder 8-Byte-Werte verwendet hat. Standardmäßig entspricht die Zeigergröße der Zeigergröße des Decodierungscomputers.

Um die Größe des Zeigers oder size_t Werts zu bestimmen, verwenden Sie das PointerSize-Element von TRACE_LOGFILE_HEADER (das erste Ereignis, das Sie in Ihrem EventRecordCallback-Rückruf erhalten, enthält diesen Header im Datenabschnitt). Dieser Wert ist jedoch möglicherweise nicht richtig. Beispielsweise protokolliert eine 32-Bit-Anwendung auf einem 64-Bit-Computer 4-Byte-Zeiger. Die Sitzung legt jedoch PointerSize auf 8 fest.
TDH_CONTEXT_PDB_PATH
Unicode-Zeichenfolge mit Null-Endung, die den Namen der PDB-Datei für die Binärdatei enthält, die WPP-Nachrichten enthält. Dieser Parameter kann als Alternative zum TDH_CONTEXT_WPP_TMFFILE oder TDH_CONTEXT_WPP_TMFSEARCHPATH verwendet werden.

Hinweis Nur für Windows 8 und Windows Server 2012 verfügbar.

 
TDH_CONTEXT_MAXIMUM
Reserviert.

Hinweise

Wenn Sie Kontextinformationen für ein älteres ETW-Ereignis angeben, müssen Sie nur den TDH_CONTEXT_POINTERSIZE-Typ angeben. Die anderen Typen werden für WPP-Ereignisse verwendet und für ÄLTERE ETW-Ereignisse ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile tdh.h

Weitere Informationen

TDH_CONTEXT