Classe TraceLoggingThreadActivity (traceloggingactivity.h)
Fornisce supporto per la registrazione di eventi ETW durante un'attività. Gli eventi verranno contrassegnati automaticamente con o annidati in questa attività.
Ereditarietà
La classe TraceLoggingThreadActivity implementa _TlgActivityBase.
Metodi
La classe TraceLoggingThreadActivity include questi metodi.
TraceLoggingThreadActivity::P rovider TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) restituisce l'handle al provider TraceLogging associato a questa attività. |
TraceLoggingThreadActivity::TraceLoggingThreadActivity Inizializza una nuova istanza della classe TraceLoggingThreadActivity. (overload 2/2) |
TraceLoggingThreadActivity::TraceLoggingThreadActivity Inizializza una nuova istanza della classe TraceLoggingThreadActivity. (overload 1/2) |
Commenti
Questa classe funziona impostando una variabile per thread. Solo gli eventi che si verificano nel thread attivo verranno contrassegnati automaticamente.
Per usare le attività TraceLogging, è necessario definire un'istanza di TraceLoggingActivity o TraceLoggingThreadActivity. Dopo aver creato un'istanza di una di queste classi, è possibile modificare la registrazione delle attività usando Dopo aver creato un'istanza di una di queste classi, è possibile modificare la registrazione delle attività usando TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop e TraceLoggingWriteTagged. Questa classe crea automaticamente un identificatore univoco quando viene attivata la traccia e l'attività viene avviata.
Tutti i thread attivi verranno annidati automaticamente in questa istanza quando si inizia la registrazione con un oggetto TraceLoggingThreadActivity . Inoltre, tutti gli eventi verranno registrati automaticamente con l'identificatore univoco di questo oggetto.
Importante
Usare questa classe solo quando è possibile garantire che tutte le attività per questo thread siano completamente annidate. È necessario assicurarsi che nessuna attività figlio avrà esito negativo per un'attività padre, anche in casi di errore o casi limite.
Nota
Nelle compilazioni DEBUG la classe genererà un'asserzione durante l'evento Stop, se rileva un annidamento di attività non corretto o se l'evento Stop si verifica in un thread diverso dal thread usato per avviarlo.
Questa classe non è disponibile per le applicazioni di archiviazione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2012 R2 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | traceloggingactivity.h |