Funzione di callback ETWENABLECALLBACK (wdm.h)

Articolo
02/27/2024

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

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 in cui l'evento è abilitato. Questo parametro è un valore definito dal provider che specifica il livello dettagliato 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 di 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 e, 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 filtro eventi.

[in, out, optional] CallbackContext

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

Valore restituito

nessuno

Osservazioni

Usare 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 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.

Requisiti

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