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 Ereignisanbieterregistrierungshandle, das von der EtwRegister--Funktion zurückgegeben wird, wenn die Ereignisanbieterregistrierung 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.

Bemerkungen

Wenn für die Protokollierung eines Ereignisses zusätzliche Datenverarbeitung erforderlich ist, 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

Siehe auch

EtwProviderEnabled-