EtwEventEnabled-Funktion (wdm.h)
Die EtwEventEnabled-Funktion überprüft, ob ein Ereignis aktiviert ist.
Syntax
BOOLEAN EtwEventEnabled(
[in] REGHANDLE RegHandle,
[in] PCEVENT_DESCRIPTOR EventDescriptor
);
Parameter
[in] RegHandle
Ein Zeiger auf das Registrierungshandle des Ereignisanbieters, das von der EtwRegister-Funktion zurückgegeben wird, wenn die Registrierung des Ereignisanbieters erfolgreich ist.
[in] EventDescriptor
Ein Zeiger auf eine konstante EVENT_DESCRIPTOR.
Rückgabewert
Die EtwEventEnabled-Funktion gibt TRUE zurück, wenn das Ereignis aktiviert ist, und FALSE , wenn das Ereignis nicht aktiviert ist.
Hinweise
Wenn die Protokollierung eines Ereignisses zusätzliches Computing erfordert, kann die EtwEventEnabled-Funktion verwendet werden, um zu bestimmen, ob das Ereignis protokolliert wird, was den Aufwand minimiert, wenn die Protokollierung deaktiviert ist.
Wenn der Ereignisdeskriptor nicht verfügbar ist, verwenden Sie stattdessen die Funktion EtwProviderEnabled .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und späteren Windows-Versionen. |
| Zielplattform | Universell |
| Header | wdm.h (include Wdm.h, Ntddk.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Beliebige Ebene |