Funzione di callback WMIDPREQUEST (evntrace.h)

Articolo
02/26/2024

Un provider di eventi basato su RegisterTraceGuids ("classico") implementa questa funzione per ricevere o disabilitare le richieste di notifica dai controller.

Il tipo WMIDPREQUEST definisce un puntatore a questa funzione di callback. ControlCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

Parametri

[in] RequestCode

Codice della richiesta. Si tratta di uno dei valori seguenti.

Valore	Significato
WMI_ENABLE_EVENTS	Abilita il provider o modifica la configurazione del provider.
WMI_DISABLE_EVENTS	Disabilitazione del provider.

RequestContext

Contesto definito dal provider. Il provider usa il parametro RequestContext di
RegisterTraceGuids per specificare il contesto.

BufferSize

Riservato per utilizzo interno.

[in] Buffer

Puntatore a una struttura WNODE_HEADER che contiene informazioni sulla sessione di traccia eventi per cui il provider è abilitato o disabilitato.

Valore restituito

È necessario restituire ERROR_SUCCESS se il callback ha esito positivo. Si noti che ETW ignora il valore restituito per questa funzione, tranne quando un controller chiama EnableTrace per abilitare un provider e il provider non ha ancora chiamato RegisterTraceGuids. In questo caso, RegisterTraceGuids restituirà il valore restituito di questo callback se la registrazione ha avuto esito positivo.

Commenti

Questa funzione viene specificata usando la funzione RegisterTraceGuids . Quando il controller chiama la funzione EnableTrace per abilitare , disabilitare o modificare i flag di abilitazione o il livello, ETW chiama questo callback. Il provider abilita o disabilita se stesso in base al valore RequestCode . In genere, il provider usa questo valore per impostare un flag globale per indicare lo stato abilitato.

Il provider definisce l'interpretazione dell'abilitazione o della disabilitazione. In genere, se un provider è abilitato, genera eventi, ma mentre è disabilitato, non lo è.

ETW non passa i flag di abilitazione e abilita il livello passato dal controller alla funzione EnableTrace a questo callback. Per recuperare queste informazioni, chiamare rispettivamente le funzioni GetTraceEnableFlags e GetTraceEnableLevel .

È anche necessario recuperare l'handle di sessione in questo callback per le chiamate future. Per recuperare l'handle di sessione, chiamare la funzione GetTraceLoggerHandle .

La funzione di callback non deve chiamare alcun elemento che potrebbe comportare LoadLibrary (in particolare, qualsiasi elemento che richiede un blocco del caricatore).

Esempio

Per un esempio di implementazione di una funzione ControlCallback , vedere Scrittura di eventi classici.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	evntrace.h