evntprov.h-Header

Dieser Header wird von mehreren Technologien verwendet. Weitere Informationen finden Sie unter

• Referenz zu Treiberentwicklungstools
• Ereignisablaufverfolgung

evntprov.h enthält die folgenden Programmierschnittstellen:

Functions

EventActivityIdControl Erstellt, abfragen und legt Aktivitätsbezeichner für die Verwendung in ETW-Ereignissen fest.
EventDataDescCreate Legt die Werte eines EVENT_DATA_DESCRIPTOR fest.
EventDescCreate Legt die Werte eines Ereignisdeskriptors fest.
EventDescGetChannel Ruft den Kanal aus dem Ereignisdeskriptor ab.
EventDescGetId Ruft den Ereignisbezeichner aus dem Ereignisdeskriptor ab.
EventDescGetKeyword Ruft die Schlüsselwort (keyword) aus dem Ereignisdeskriptor ab.
EventDescGetLevel Ruft den Schweregrad aus dem Ereignisdeskriptor ab.
EventDescGetOpcode Ruft den Vorgangscode aus dem Ereignisdeskriptor ab.
EventDescGetTask Ruft die Aufgabe aus dem Ereignisdeskriptor ab.
EventDescGetVersion Ruft die Version aus dem Ereignisdeskriptor ab.
EventDescOrKeyword Fügt dem Ereignisdeskriptor eine weitere Schlüsselwort (keyword) hinzu.
EventDescSetChannel Legt das Kanalelement des Ereignisdeskriptors fest.
EventDescSetId Legt den Id-Member des Ereignisdeskriptors fest.
EventDescSetKeyword Legt das Schlüsselwortelement des Ereignisdeskriptors fest.
EventDescSetLevel Legt den Level-Member des Ereignisdeskriptors fest.
EventDescSetOpcode Legt das Opcode-Element des Ereignisdeskriptors fest.
EventDescSetTask Legt den Taskmember des Ereignisdeskriptors fest.
EventDescSetVersion Legt das Versionsmember des Ereignisdeskriptors fest.
EventDescZero Initialisiert einen Ereignisdeskriptor auf Null.
EventEnabled Bestimmt, ob ein Ereignisanbieter ein bestimmtes Ereignis basierend auf dem EVENT_DESCRIPTOR des Ereignisses generieren soll.
EventProviderEnabled Bestimmt, ob ein Ereignisanbieter ein bestimmtes Ereignis basierend auf der Ebene und dem Schlüsselwort des Ereignisses generieren soll.
EventRegister Registriert einen ETW-Ereignisanbieter und erstellt ein Handle, das zum Schreiben von ETW-Ereignissen verwendet werden kann.
EventSetInformation Konfiguriert einen ETW-Ereignisanbieter.
EventUnregister Hebt die Registrierung eines ETW-Ereignisanbieters auf.
EventWrite Schreibt ein ETW-Ereignis, das die Aktivitäts-ID des aktuellen Threads verwendet.
EventWriteEx Schreibt ein ETW-Ereignis mit einer Aktivitäts-ID, einer optionalen verwandten Aktivitäts-ID, Sitzungsfiltern und speziellen Optionen.
EventWriteString Schreibt ein ETW-Ereignis, das eine Zeichenfolge als Daten enthält. Diese Funktion sollte nicht verwendet werden.
EventWriteTransfer Schreibt ein ETW-Ereignis mit einer Aktivitäts-ID und einer optionalen zugehörigen Aktivitäts-ID.

Rückruffunktionen

PENABLECALLBACK ETW-Ereignisanbieter definieren optional eine EnableCallback-Funktion, um Konfigurationsänderungsbenachrichtigungen zu empfangen. Der PENABLECALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. EnableCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Strukturen

EVENT_DATA_DESCRIPTOR Die EVENT_DATA_DESCRIPTOR-Struktur definiert einen Datenblock, der in einem ETW-Ereignis verwendet wird.
EVENT_DESCRIPTOR Die EVENT_DESCRIPTOR-Struktur enthält Informationen (Metadaten) zu einem ETW-Ereignis.
EVENT_FILTER_DESCRIPTOR Definiert die Filterdaten, die eine Sitzung an die Rückruffunktion enable des Anbieters übergibt.
EVENT_FILTER_EVENT_ID Definiert Ereignis-IDs, die in einer EVENT_FILTER_DESCRIPTOR-Struktur für eine Ereignis-ID oder einen Stapellauffilter verwendet werden.
EVENT_FILTER_EVENT_NAME Definiert Ereignis-IDs, die in einer EVENT_FILTER_DESCRIPTOR-Struktur für einen Ereignisnamen oder Stalk-Walknamenfilter verwendet werden.
EVENT_FILTER_HEADER Definiert die Headerdaten, die den Filterdaten vorangestellt werden müssen, die im Instrumentierungsmanifest definiert sind.
EVENT_FILTER_LEVEL_KW Definiert Ereignis-IDs, die in einer EVENT_FILTER_DESCRIPTOR-Struktur für einen Stapellauf Schlüsselwort (keyword) Filter verwendet werden.

Enumerationen

EVENT_INFO_CLASS Der EVENT_INFO_CLASS Enumerationstyp wird mit der EventSetInformation-Funktion verwendet, um den Konfigurationsvorgang anzugeben, der für eine ETW-Ereignisanbieterregistrierung ausgeführt werden soll.