TDH_CONTEXT_TYPE-Enumeration (tdh.h)

Artikel
03/02/2024

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

Freigeben über