TraceLoggingOpcode-Makro (traceloggingprovider.h)
TraceLogging-Wrappermakro , das den Opcode für das Ereignis festlegt.
Syntax
void TraceLoggingOpcode(
[in] eventOpcode
);
Parameter
[in] eventOpcode
Eine 8-Bit-Zahl, die verwendet wird, um Ereignisse mit einer speziellen Semantik zu markieren. Dieser Wert muss eine Kompilierzeitkonstante im Bereich von 0 bis 255 sein.
Der Opcode wird von Ablaufverfolgungsdecodern verwendet, um Ereignisse zu organisieren und zu korrelieren.
Global erkannte Opcodewerte werden in winmeta.hdefiniert. Die meisten Ereignisse verwenden 0 (WINEVENT_OPCODE_INFO), um anzugeben, dass das Ereignis keine spezielle Semantik aufweist.
Die Opcodewerte 10 bis 239 können benutzerdefinierte Semantiken erhalten.
Ausführliche Informationen zum Ereignis-Opcode finden Sie unter EVENT_DESCRIPTOR .
Rückgabewert
Keine
Bemerkungen
TraceLoggingOpcode(eventOpcode) kann als Parameter für einen Aufruf eines TraceLoggingWrite-Makros verwendet werden, um den Opcode des Ereignisses festzulegen.
Wenn keine TraceLoggingOpcode-Makros für einen TraceLoggingWrite-Aufruf bereitgestellt werden, ist der Standard-Opcode des Ereignisses 0 (WINEVENT_OPCODE_INFO). Wenn mehrere TraceLoggingOpcode-Makros bereitgestellt werden, wird der letzte Wert verwendet.
Opcodes WINEVENT_OPCODE_START (1) und WINEVENT_OPCODE_STOP (2) werden verwendet, um den Beginn und das Ende der ETW-Aktivitäten wie folgt anzugeben:
- Generieren Sie eine Aktivitäts-ID, die innerhalb der Ablaufverfolgung eindeutig ist, in der Regel mit EventActivityIdControl oder UuidCreate.
- Schreiben Sie ein Startereignis mit opcode = START, Aktivitäts-ID = die generierte Aktivitäts-ID und die zugehörige Aktivitäts-ID = die id der übergeordneten Aktivität (oder NULL, wenn keine übergeordnete Aktivitäts-ID vorhanden ist).
- Schreiben Sie eine beliebige Anzahl von Aktivitätsinformationsereignissen mit opcode = INFO, Aktivitäts-ID = die generierte Aktivitäts-ID.
- Schreiben Sie ein Stoppereignis mit opcode = STOP, Aktivitäts-ID = die generierte Aktivitäts-ID.
Ablaufverfolgungs-Decodierungstools können diese Ereignisse dann basierend auf ihren Aktivitäts-IDs in Gruppen organisieren.
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 |