ETWENABLECALLBACK-Rückruffunktion (wdm.h)
Die EtwEnableCallback--Funktion ist eine optionale vom Treiber bereitgestellte Rückruffunktion, die verwendet wird, um Benachrichtigungen zu aktivieren oder zu deaktivieren.
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 Levelwert ist.
Dieser Wert wird im parameter Level der EnableTraceEx-Funktion oder dem EnableLevel Parameter der EnableTrace-Funktion übergeben.
[in] MatchAnyKeyword
Die Bitmaske von Schlüsselwörtern, die der Anbieter verwendet, um die Kategorie von Ereignissen zu bestimmen, die er schreibt.
Dieser Wert wird im MatchAnyKeyword Parameter der EnableTraceEx--Funktion oder dem EnableFlag Parameter der EnableTrace--Funktion übergeben. MatchAnyKeyword- ist ein 64-Bit-Wert und ist im Grunde eine erweiterte Version der 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 dessen Zweck. Beispielsweise kann der Anbieter diese Daten verwenden, um die von ihr geschriebenen Ereignisse zusätzlich zu filtern oder zum Ausführen einiger Berechnungen vor dem Schreiben der Ereignisse zu verwenden. Ausführliche Informationen finden Sie unter Ereignisfilterdeskriptor.
[in, out, optional] CallbackContext
Der Kontext der Rückruffunktion, die definiert wird, wenn der Anbieter EtwRegister aufgerufen, um sich selbst zu registrieren. Dieser Parameter ist optional.
Rückgabewert
Nichts
Bemerkungen
Verwenden Sie die EtwRegister-Funktion, um einen Zeiger auf die EtwEnableCallback--Funktion anzugeben.
Verwenden Sie den FilterData Parameter der Rückruffunktion, um den Anbieter mit anspruchsvollen Filterfähigkeiten zu versorgen. Die funktion EtwEnableCallback ersetzt nicht die Aufrufe der Funktion "enable-status" (EtwEventEnabled und EtwProviderEnabled). Sie dient jedoch als Ergänzung zu ihnen. Es sei denn, Ihre Ebene und Schlüsselwörter sind derzeit aktiviert, wird das Ereignis nicht geschrieben, unabhängig von der FilterData-, die die Rückruffunktion bereitstellt.
Aufrufer von EtwEnableCallback- müssen unter IRQL = PASSIVE_LEVEL im Kontext eines Systemthreads ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h) |
| IRQL- | PASSIVE_LEVEL |