Funzione WdfWmiProviderGetTracingHandle (wdfwmi.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfWmiProviderGetTracingHandle restituisce un handle al logger di eventi di una sessione di traccia software WPP .

Sintassi

ULONGLONG WdfWmiProviderGetTracingHandle(
  [in] WDFWMIPROVIDER WmiProvider
);

Parametri

[in] WmiProvider

Handle per un oggetto provider WMI ottenuto dal driver chiamando WdfWmiProviderCreate o WdfWmiInstanceGetProvider.

Valore restituito

WdfWmiProviderGetTracingHandle restituisce un handle al logger di traccia eventi.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Se un driver imposta il flag WdfWmiProviderTracing nel membro Flags della struttura WDF_WMI_PROVIDER_CONFIG dell'oggetto provider WMI, può chiamare WdfWmiProviderGetTracingHandle per ottenere un handle di traccia dopo la registrazione di un'istanza del provider. Il driver può usare l'handle di traccia come input per la routine WmiTraceMessage .

Per altre informazioni sul metodo WdfWmiProviderGetTracingHandle , vedere Supporto della traccia eventi WMI. Per altre informazioni su WMI, vedere Supporto di WMI nei driver Framework-Based.

Esempio

Nell'esempio di codice seguente viene ottenuto un handle per il logger di eventi di una sessione di traccia WPP.

ULONGLONG tracingHandle;

tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfwmi.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate