Delen via


Over gebeurtenistracering voor stuurprogramma's

Gedefinieerde gebeurtenistracering

Event Tracing voor Windows (ETW) is een efficiënt en effectief mechanisme voor het traceren en vastleggen van gebeurtenissen die worden gegenereerd door toepassingen in de gebruikersmodus en stuurprogramma's voor kernelmodus. ETW bestaat uit drie onderdelen:

Termijn Beschrijving

Aanbieders

Toepassingen of onderdelen die instrumentatie voor gebeurtenistracering genereren.

Regelaars

Toepassingen die sessies voor gebeurtenistracering starten, stoppen en configureren.

Consumenten

Toepassingen die gebeurtenistraceringssessies (in realtime) of vanuit een bestand ontvangen.

De ETW Kernel-Mode-API

De API (ETW Application Programming Interface) biedt een set functies die beschikbaar zijn voor onderdelen en stuurprogramma's in de kernelmodus. WMI Event Tracing en WPP Software Tracing maken beide gebruik van ETW. Ontwikkelaars van stuurprogramma's kunnen deze functies gebruiken om het stuurprogramma te registreren als EEN ETW-provider. ETW-providers kunnen gebeurtenissen genereren en publiceren naar het Windows-gebeurtenislogboek of hun gebeurtenissen naar een ETW-sessie schrijven, die naar een traceringsbestand wordt geschreven of aan de realtime consument wordt geleverd. Gebeurtenissen zijn entiteiten die interessante gebeurtenissen binnen het systeem beschrijven en worden gedefinieerd door een set kenmerken die worden bepaald door de ETW-providers.

ETW wordt geïmplementeerd in het Windows-besturingssysteem en biedt ontwikkelaars een snelle, betrouwbare en veelzijdige set functies voor gebeurtenistracering met zeer weinig invloed op prestaties. U kunt tracering dynamisch in- of uitschakelen zonder uw computer opnieuw op te starten of uw toepassing of stuurprogramma opnieuw te laden. In tegenstelling tot foutopsporingsinstructies die u tijdens de ontwikkeling aan uw code toevoegt, kunt u ETW gebruiken in uw productiecode.

Wanneer gebruikt u gebeurtenistracering?

Gebruik de API voor de ETW-kernelmodus als u gebeurtenissen wilt publiceren die kunnen worden gebruikt door toepassingen die geïnteresseerd zijn in administratieve, operationele en analytische gebeurtenissen, naast de gedetailleerde tracering die u mogelijk nodig hebt tijdens de ontwikkeling. Gebruik WPP-softwaretracering als u voornamelijk traceringsgegevens wilt verzamelen voor ontwikkelings- en foutopsporingsdoeleinden.