TraceLoggingKeyword-Makro (traceloggingprovider.h)

  • Artikel

TraceLogging-Wrappermakro, das die Schlüsselwort (keyword) für das Ereignis festlegt.

Syntax

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Parameter

[in] eventKeyword

Eine 64-Bit-Bit-Maske, die verwendet wird, um die Mitgliedschaft eines Ereignisses in einer Reihe von Ereigniskategorien anzugeben. Dieser Wert muss eine Kompilierzeitkonstante sein.

Wichtig

ProviderId, Level und Keyword sind die wichtigsten Mittel zum Filtern von Ereignissen. Andere Filterarten sind möglich, haben aber einen viel höheren Aufwand. Weisen Sie jedem Ereignis immer eine sinnvolle Nicht-Null-Ebene zu und Schlüsselwort (keyword).

Weitere Informationen zum ereignisbasierten Schlüsselwort (keyword) finden Sie unter EVENT_DESCRIPTOR.

Rückgabewert

Keine

Bemerkungen

TraceLoggingKeyword(eventKeyword)kann als Parameter für einen Aufruf eines TraceLoggingWrite-Makros verwendet werden, um die Schlüsselwort (keyword) des Ereignisses festzulegen. Ereignis Schlüsselwort (keyword) ist ein primäres Mittel zum Filtern von Ereignissen. Weisen Sie jedem Ereignis immer einen aussagekräftigen (ungleich null) Schlüsselwort (keyword) zu.

Wenn für einen TraceLoggingWrite-Aufruf keine TraceLoggingKeyword-Makros bereitgestellt werden, ist die Standard-Schlüsselwort (keyword) des Ereignisses 0. Wenn mehrere TraceLoggingKeyword-Makros bereitgestellt werden, sind die Werte OR'ed.

Die obersten 16 Bits der Schlüsselwort (keyword) (Bitmaske 0xFFFF000000000000) werden von Microsoft definiert. Die niedrigen 48 Bits des Schlüsselwort (keyword) (Bitmaske 0x0000FFFFFFFFFFFF) werden vom Ereignisanbieter definiert. Der Ereignisanbieter kann beispielsweise Bit 0 (Bitmaske 0x1) als "E/A"-Kategorie, Bit 1 (Bitmaske 0x2) als Kategorie "UI" und Bit 2 (Bitmaske 0x4) als Kategorie "Leistungsmessung" definieren. In diesem Szenario kann sein Schlüsselwort (keyword) auf 0x5 festgelegt sein, was angibt, dass das Ereignis sowohl in den Kategorien "E/A" als auch "Leistungsmessung" enthalten ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile traceloggingprovider.h

Weitere Informationen

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging-Wrappermakros