Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Följande konstanter representerar möjliga loggningslägen för en händelsespårningssession.
Konstanterna används i LogFileMode medlemmar i EVENT_TRACE_LOGFILE, EVENT_TRACE_PROPERTIES och TRACE_LOGFILE_HEADER strukturer. Dessa konstanter definieras i Evntrace.h- huvudfil.
| Läge | Beskrivning |
|---|---|
| EVENT_TRACE_FILE_MODE_NONE (0x00000000) | Samma som EVENT_TRACE_FILE_MODE_SEQUENTIAL utan att någon maximal filstorlek har angetts. |
| EVENT_TRACE_FILE_MODE_SEQUENTIAL (0x00000001) | Skriver händelser till en loggfil sekventiellt. stoppas när filen når sin maximala storlek. Använd inte med EVENT_TRACE_FILE_MODE_CIRCULAR eller EVENT_TRACE_FILE_MODE_NEWFILE. |
| EVENT_TRACE_FILE_MODE_CIRCULAR (0x00000002) | Skriver händelser till en loggfil. När filen har nått den maximala storleken ersätts de äldsta händelserna med inkommande händelser. Observera att innehållet i den cirkulära loggfilen kan visas i oordning på datorer med flera processorer. Använd inte med EVENT_TRACE_FILE_MODE_APPEND, EVENT_TRACE_FILE_MODE_NEWFILEeller EVENT_TRACE_FILE_MODE_SEQUENTIAL. |
| EVENT_TRACE_FILE_MODE_APPEND (0x00000004) | Lägger till händelser i en befintlig sekventiell loggfil. Om filen inte finns skapas den. Använd endast om du anger systemtid för klockupplösningen, annars returnerar ProcessTrace händelser med felaktiga tidsstämplar. När du använder EVENT_TRACE_FILE_MODE_APPENDmåste värdena för BufferSize, NumberOfProcessorsoch ClockType anges uttryckligen och måste vara desamma i både loggaren och filen som läggs till. Använd inte med EVENT_TRACE_REAL_TIME_MODE, EVENT_TRACE_FILE_MODE_CIRCULAR, EVENT_TRACE_FILE_MODE_NEWFILEeller EVENT_TRACE_PRIVATE_LOGGER_MODE. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_FILE_MODE_NEWFILE (0x00000008) | Växlar automatiskt till en ny loggfil när filen når den maximala storleken.
MaximumFileSize medlem i EVENT_TRACE_PROPERTIES måste anges. Det angivna filnamnet måste vara en formaterad sträng (till exempel innehåller strängen en %d, till exempel c:\test%d.etl). Varje gång en ny fil skapas ökas en räknare och dess värde används, den formaterade strängen uppdateras och den resulterande strängen används som filnamn. Det här alternativet är inte tillåtet för privata händelsespårningssessioner och bör inte användas för NT-kernelloggningssessioner. Använd inte med EVENT_TRACE_FILE_MODE_CIRCULAR, EVENT_TRACE_FILE_MODE_APPEND eller EVENT_TRACE_FILE_MODE_SEQUENTIAL. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_FILE_MODE_PREALLOCATE(0x00000020) | Reserverar EVENT_TRACE_PROPERTIES.MaximumFileSize bytes diskutrymme för loggfilen i förväg. Filen upptar hela utrymmet under loggningen, för både cirkulära och sekventiella loggfiler. När du stoppar sessionen minskas loggfilen till den storlek som behövs. Du måste ange EVENT_TRACE_PROPERTIES. MaximumFileSize. Du kan inte använda läget för privata händelsespårningssessioner. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_NONSTOPPABLE_MODE(0x00000040) | Loggningssessionen kan inte stoppas. Det här läget stöds endast av Autologger.Det här alternativet stöds i Windows Vista och senare. . |
| EVENT_TRACE_SECURE_MODE (0X00000080) | Begränsar vem som kan logga händelser till sessionen till dem med TRACELOG_LOG_EVENT behörighet. Det här alternativet stöds i Windows Vista och senare. |
| EVENT_TRACE_REAL_TIME_MODE (0x00000100) | Levererar händelserna till konsumenter i realtid. Händelser levereras när buffertarna töms, inte när providern skriver händelsen. Du bör inte aktivera realtidsläge om det inte finns några användare som kan använda händelserna eftersom anrop till logghändelser till slut misslyckas när buffertarna blir fulla. Om händelserna inte förbrukades, blev de borttagna innan Windows Vista. Ange inte fler än en realtidskonsument i en process på Windows XP eller Windows Server 2003. Låt i stället en tråd bearbeta händelser och distribuera dem till andra. Före Windows Vista: Du bör inte använda realtidsläge eftersom händelsefrekvensen som stöds är mycket lägre än läsning från loggfilen (händelser kan tas bort). Dessutom garanteras inte händelseordningen på datorer med flera processorer. Realtidsläget är mer lämpligt för händelser av typen av meddelandetyp med låg trafik. Du kan kombinera det här läget med andra loggfilslägen. Använd dock inte det här läget med EVENT_TRACE_PRIVATE_LOGGER_MODE. Observera att om du kombinerar det här läget med andra loggfilslägen rensas buffertar en gång i sekunden, vilket resulterar i att delvis fyllda buffertar skrivs till loggfilen. Om du till exempel använder 64k-buffertar och loggningsfrekvensen är 1 händelse varje sekund, skriver tjänsten 64k/sekund till loggfilen. |
| EVENT_TRACE_DELAY_OPEN_FILE_MODE(0x00000200) | Det här läget används för att fördröja öppnandet av loggfilen tills en händelse inträffar. Obs! I Windows Vista eller senare är det här läget inte tillämpligt och bör inte användas. |
| EVENT_TRACE_BUFFERING_MODE (0x00000400) | Det här läget skriver händelser till en cirkelminnesbuffert. Händelser som skrivs bortom buffertens totala storlek påverkar de äldsta händelserna som fortfarande finns kvar i bufferten. Storleken på den här minnesbufferten är produkten av MinimumBuffers och BufferSize (se EVENT_TRACE_PROPERTIES). Som en följd av den här formeln ignorerar alla buffertar som använder EVENT_TRACE_BUFFERING_MODE värdet MaximumBuffers. Händelser skrivs inte till en loggfil eller levereras i realtid och ETW rensar inte buffertarna. Om du vill få en ögonblicksbild av bufferten anropar du funktionen FlushTrace. Det här läget är särskilt användbart för att felsöka enhetsdrivrutiner tillsammans med möjligheten att visa innehållet i minnesinterna buffertar med WMITrace- kernelbugger-tillägget. Använd inte med EVENT_TRACE_FILE_MODE_SEQUENTIAL, EVENT_TRACE_FILE_MODE_CIRCULAR, EVENT_TRACE_FILE_MODE_APPEND, EVENT_TRACE_FILE_MODE_NEWFILEeller EVENT_TRACE_REAL_TIME_MODE. |
| EVENT_TRACE_PRIVATE_LOGGER_MODE (0x00000800) | Skapar en händelsespårningssession i användarläge som körs i samma process som dess händelsespårningsprovider. Minnet för buffertar kommer från processens minne. Processer som inte kräver data från kerneln kan eliminera de omkostnader som är associerade med övergångar i kernelläge med hjälp av en privat händelsespårningssession. Om providern registreras av flera processer lägger ETW till processidentifieraren i loggfilens namn för att skapa ett unikt loggfilnamn. Om kontrollanten till exempel anger loggfilnamnen som c:\mylogs\myprivatelog.etl skapar ETW loggfilen som c:\mylogs\myprivatelog.etl_nnnn, där nnnn är processidentifieraren. Processidentifieraren läggs inte till i den första processen som registrerar providern. Den läggs endast till i efterföljande processer som registrerar providern. Privata händelsespårningssessioner har följande begränsningar:
Du kan använda det här läget tillsammans med EVENT_TRACE_PRIVATE_IN_PROC läge. Före Windows 10 version 1703: Endast LocalSystem, administratören och användare i administratörsgruppen som körs i en upphöjd process kan skapa en privat session. Om du inkluderar flaggan EVENT_TRACE_PRIVATE_IN_PROC kan alla användare skapa en privat session under processen. I tidigare versioner av Windows kan det dessutom bara finnas en privat session per process (såvida inte EVENT_TRACE_PRIVATE_IN_PROC-läget också anges, i vilket fall du kan skapa upp till tre privata sessioner i processen). Före Windows Vista: Användare i gruppen Användare av prestandaloggar kan också skapa en privat session. Använd inte med EVENT_TRACE_REAL_TIME_MODE. Före Windows 7 och Windows Server 2008 R2: Använd inte med EVENT_TRACE_FILE_MODE_NEWFILE. |
| EVENT_TRACE_ADD_HEADER_MODE(0x00001000) | Det här alternativet lägger till en rubrik i loggfilen. Obs! I Windows Vista eller senare är det här läget inte tillämpligt och bör inte användas. |
| EVENT_TRACE_USE_KBYTES_FOR_SIZE(0x00002000) | Använd kilobyte som måttenhet för att ange storleken på en fil. Standardmåttenheten är megabyte. Det här läget gäller för registervärdet MaxFileSize för en AutoLogger--session och MaximumFileSize medlem i EVENT_TRACE_PROPERTIES. Det här alternativet stöds i Windows Vista och senare. |
| EVENT_TRACE_USE_GLOBAL_SEQUENCE(0x00004000) | Använder sekvensnummer som är unika för händelsespårningssessioner. Det här läget gäller endast händelser som loggas med funktionen TraceMessage. Mer information finns i TraceMessage för användningsinformation. EVENT_TRACE_USE_GLOBAL_SEQUENCE och EVENT_TRACE_USE_LOCAL_SEQUENCE utesluter varandra. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_USE_LOCAL_SEQUENCE (0x00008000) | Använder sekvensnummer som endast är unika för en enskild händelsespårningssession. Det här läget gäller endast händelser som loggas med funktionen TraceMessage. Mer information finns i TraceMessage för användningsinformation. EVENT_TRACE_USE_GLOBAL_SEQUENCE och EVENT_TRACE_USE_LOCAL_SEQUENCE utesluter varandra. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_RELOG_MODE (0x00010000) | Loggar händelsen utan att inkludera EVENT_TRACE_HEADER.Observera: Det här läget bör inte användas. Den är reserverad för internt bruk. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_PRIVATE_IN_PROC (0x00020000) | Använd tillsammans med EVENT_TRACE_PRIVATE_LOGGER_MODE läge för att starta en privat session. Det här läget framtvingar att endast den process som registrerade providerns GUID kan starta loggningssessionen med det GUID:et. Du kan skapa upp till tre pågående privata sessioner per process. Det här alternativet stöds i Windows Vista och senare. |
| EVENT_TRACE_MODE_RESERVED(0x00100000) | Det här alternativet används för att signalera heap- och kritisk avsnittsspårning. Det här alternativet stöds i Windows Vista och senare. |
| EVENT_TRACE_STOP_ON_HYBRID_SHUTDOWN(0x00400000) | Det här alternativet stoppar loggning vid hybridavstängning. Om varken EVENT_TRACE_STOP_ON_HYBRID_SHUTDOWN eller EVENT_TRACE_PERSIST_ON_HYBRID_SHUTDOWN anges väljer ETW ett standardvärde baserat på om anroparen kommer från session 0 eller inte. Det här alternativet stöds på Windows 8 och Windows Server 2012. |
| EVENT_TRACE_PERSIST_ON_HYBRID_SHUTDOWN(0x00800000) | Det här alternativet fortsätter att logga under hybridavstängning. Om varken EVENT_TRACE_STOP_ON_HYBRID_SHUTDOWN eller EVENT_TRACE_PERSIST_ON_HYBRID_SHUTDOWN anges väljer ETW ett standardvärde baserat på om anroparen kommer från session 0 eller inte. Det här alternativet stöds på Windows 8 och Windows Server 2012. |
| EVENT_TRACE_USE_PAGED_MEMORY (0x01000000) | Använder sidsidigt minne. Den här inställningen rekommenderas så att händelser inte använder det icke-sidsidiga minnet. Buffertar som inte är sidsidiga använder icke-sidsidigt minne för buffertutrymme. Eftersom buffertar som inte är sidsidiga aldrig är utskridbara presterar en loggningssession bra. Det är mindre resurskrävande att använda sidindelade buffertar. Kernel-mode providers och systemloggare kan inte logga händelser till sessioner som specificerar detta loggningsläge. Det här läget ignoreras om EVENT_TRACE_PRIVATE_LOGGER_MODE har angetts. Du kan inte använda det här läget med NT Kernel Logger. Windows 2000: Det här värdet stöds inte. |
| EVENT_TRACE_SYSTEM_LOGGER_MODE(0x02000000) | Det här alternativet tar emot händelser från SystemTraceProvider. Om parametern StartTracePropertiesLogFileMode innehåller den här flaggan blir loggaren en systemloggare. Det här alternativet stöds på Windows 8 och Windows Server 2012. |
| EVENT_TRACE_INDEPENDENT_SESSION_MODE(0x08000000) | Anger att en loggningssession inte ska påverkas av EventWrite fel i andra sessioner. Om en händelse inte kan publiceras till någon av de sessioner som en leverantör är aktiverad för utan den här flaggan kommer händelsen inte att publiceras till någon av sessionerna. När den här flaggan har angetts kommer ett misslyckande att skriva en händelse till en session inte leda till att funktionen EventWrite returnerar en felkod i andra sessioner. Använd inte tillsammans med EVENT_TRACE_PRIVATE_LOGGER_MODE. Det här alternativet stöds på Windows 8.1, Windows Server 2012 R2 och senare. |
| EVENT_TRACE_NO_PER_PROCESSOR_BUFFERING (0x10000000) | Skriver händelser som loggades på olika processorer till en gemensam buffert. Med det här läget kan du eliminera problemet med händelser som visas i fel ordning när händelser publiceras på olika processorer med hjälp av systemtid. Det här läget kan också eliminera problemet med cirkulära loggar som verkar släppa händelser på flera processordatorer. Om du inte använder det här läget och använder systemtid kan händelserna visas i fel ordning på flera processordatorer. Det beror på att ETW-buffertar är associerade med en processor i stället för en tråd. Om en tråd växlas från en processor till en annan kan bufferten som är associerad med den senare processorn därför rensas till disken före den som är associerad med den tidigare processorn. Om du förväntar dig en stor mängd händelser (till exempel fler än 1 000 händelser per sekund) bör du inte använda det här läget. Observera att processornumret inte ingår i händelsen. Det här alternativet stöds på Windows 7, Windows Server 2008 R2 och senare. |
| EVENT_TRACE_ADDTO_TRIAGE_DUMP(0x80000000) | Det här alternativet lägger till ETW-buffertar för att sortera dumpar. Det här alternativet stöds på Windows 8 och Windows Server 2012. |