Funzione WdfWmiProviderGetTracingHandle (wdfwmi.h)
[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.
Osservazioni
Se un driver imposta il flag di WdfWmiProviderTracing nel Flags membro della struttura di 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 di WdfWmiProviderGetTracingHandle, vedere Support WMI Event Tracing. Per altre informazioni su WMI, vedere Supporto di WMI in Framework-Based driver.
Esempi
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);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 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) |