ETWENABLECALLBACK-Rückruffunktion (wdm.h)
Die EtwEnableCallback-Funktion ist eine optionale vom Treiber bereitgestellte Rückruffunktion, die zum Empfangen von Aktivierungs- oder Deaktivierungsbenachrichtigungen verwendet wird.
Syntax
ETWENABLECALLBACK Etwenablecallback;
void Etwenablecallback(
[in] LPCGUID SourceId,
ULONG ControlCode,
[in] UCHAR Level,
[in] ULONGLONG MatchAnyKeyword,
[in] ULONGLONG MatchAllKeyword,
[in, optional] PEVENT_FILTER_DESCRIPTOR FilterData,
[in, out, optional] PVOID CallbackContext
)
{...}
Parameter
[in] SourceId
Die GUID, die die Sitzung identifiziert, die den Anbieter aktiviert hat.
ControlCode
[in] Level
Die Ebene, auf der das Ereignis aktiviert ist. Dieser Parameter ist ein vom Anbieter definierter Wert, der die Ausführlichkeit der Ereignisse angibt, die der Anbieter schreibt. Der Anbieter muss das Ereignis schreiben, wenn dieser Wert kleiner oder gleich dem vom Ereignis definierten Ebenenwert ist.
Dieser Wert wird im Level-Parameter der EnableTraceEx-Funktion oder im EnableLevel-Parameter der EnableTrace-Funktion übergeben.
[in] MatchAnyKeyword
Die Bitmaske von Schlüsselwörtern, die der Anbieter verwendet, um die Kategorie der ereignisse zu bestimmen, die er schreibt.
Dieser Wert wird im MatchAnyKeyword-Parameter der EnableTraceEx-Funktion oder im EnableFlag-Parameter der EnableTrace-Funktion übergeben. MatchAnyKeyword ist ein 64-Bit-Wert und ist im Grunde eine erweiterte Version von 32-Bit EnableFlag.
[in] MatchAllKeyword
Diese Bitmaske schränkt zusätzlich die Kategorie von Ereignissen ein, die der Anbieter schreibt.
Dieser Wert wird im MatchAllKeywords-Parameter der EnableTraceEx-Funktion übergeben.
[in, optional] FilterData
Die vom Anbieter definierten Daten. Dieser Parameter ist optional. Der Anbieter bestimmt das Layout der Daten und deren Zweck. Beispielsweise kann der Anbieter diese Daten verwenden, um die ereignisse, die er schreibt, zusätzlich zu filtern oder um einige Berechnungen durchzuführen, bevor er die Ereignisse schreibt. Ausführliche Informationen finden Sie unter Ereignisfilterdeskriptor.
[in, out, optional] CallbackContext
Der Kontext der Rückruffunktion, der definiert wird, wenn der Anbieter EtwRegister aufgerufen hat, um sich selbst zu registrieren. Dieser Parameter ist optional.
Rückgabewert
Keine
Bemerkungen
Verwenden Sie die EtwRegister-Funktion, um einen Zeiger auf die Funktion EtwEnableCallback anzugeben.
Verwenden Sie den FilterData-Parameter der Rückruffunktion, um dem Anbieter anspruchsvolle Filterfunktionen zur Verfügung zu stellen. Die Funktion EtwEnableCallback ersetzt nicht die Funktionsaufrufe enable-status (EtwEventEnabled und EtwProviderEnabled). Es dient jedoch als Ergänzung zu ihnen. Es sei denn, Ihre Ebene und Die Schlüsselwörter sind derzeit aktiviert, wird das Ereignis nicht geschrieben, unabhängig von der FilterData-Funktion , die die Rückruffunktion bereitstellt.
Aufrufer von EtwEnableCallback müssen unter IRQL = PASSIVE_LEVEL im Kontext eines Systemthreads ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und späteren Windows-Versionen. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (include Wdm.h, Ntddk.h) |
| IRQL | PASSIVE_LEVEL |