Funzione di callback ETWENABLECALLBACK (wdm.h)

Articolo
02/07/2025

La funzione EtwEnableCallback è una funzione di callback fornita dal driver facoltativa usata per ricevere o disabilitare le notifiche.

Sintassi

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
)
{...}

Parametri

[in] SourceId

GUID che identifica la sessione che ha abilitato il provider.

ControlCode

[in] Level

Livello a cui è abilitato l'evento. Questo parametro è un valore definito dal provider che specifica il livello di dettaglio degli eventi scritti dal provider. Il provider deve scrivere l'evento se questo valore è minore o uguale al valore di livello definito dall'evento.

Questo valore viene passato nel parametro Level della funzione EnableTraceEx o nel parametro EnableLevel della funzione EnableTrace.

[in] MatchAnyKeyword

Maschera di bit delle parole chiave usate dal provider per determinare la categoria di eventi che scrive.

Questo valore viene passato nel parametro MatchAnyKeyword della funzione EnableTraceEx o nel parametro EnableFlag della funzione EnableTrace. MatchAnyKeyword è un valore a 64 bit ed è fondamentalmente una versione estesa del EnableFlag a 32 bit.

[in] MatchAllKeyword

Questa maschera di bit limita inoltre la categoria di eventi scritti dal provider.

Questo valore viene passato nel parametro MatchAllKeywords della funzione EnableTraceEx.

[in, optional] FilterData

Dati definiti dal provider. Questo parametro è facoltativo. Il provider determina il layout dei dati e il relativo scopo. Ad esempio, il provider può usare questi dati per filtrare ulteriormente gli eventi scritti o usarli per eseguire alcuni calcoli prima di scrivere gli eventi. Per informazioni dettagliate, vedere descrittore di filtro eventi .

[in, out, optional] CallbackContext

Contesto della funzione di callback definita quando il provider ha chiamato EtwRegister per la registrazione. Questo parametro è facoltativo.

Valore restituito

Nessuno

Osservazioni

Utilizzare la funzione EtwRegister per specificare un puntatore alla funzione EtwEnableCallback .

Usare il parametro filterData della funzione di callback per fornire al provider funzionalità di filtro sofisticate. La funzione EtwEnableCallback non sostituisce le chiamate di funzione enable-status (EtwEventEnabled e EtwProviderEnabled). Tuttavia, serve come un supplemento a loro. Tuttavia, a meno che il livello e le parole chiave non siano attualmente abilitati, l'evento non verrà scritto, indipendentemente dal FilterData fornito dalla funzione di callback.

I chiamanti di EtwEnableCallback devono essere in esecuzione in IRQL = PASSIVE_LEVEL nel contesto di un thread di sistema.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	wdm.h (include Wdm.h, Ntddk.h)
IRQL	PASSIVE_LEVEL