WdfWmiProviderGetTracingHandle-Funktion (wdfwmi.h)
[Gilt nur für KMDF]
Die WdfWmiProviderGetTracingHandle-Methode gibt ein Handle an die Ereignisprotokollierung einer WPP-Softwareablaufverfolgungssitzung zurück.
Syntax
ULONGLONG WdfWmiProviderGetTracingHandle(
[in] WDFWMIPROVIDER WmiProvider
);
Parameter
[in] WmiProvider
Ein Handle für ein WMI-Anbieterobjekt, das der Treiber durch Aufrufen von WdfWmiProviderCreate oder WdfWmiInstanceGetProvider abgerufen hat.
Rückgabewert
WdfWmiProviderGetTracingHandle gibt ein Handle an die Ereignisablaufverfolgungsprotokollierung zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Wenn ein Treiber das WdfWmiProviderTracing-Flag im Flags-Member der WDF_WMI_PROVIDER_CONFIG Struktur des WMI-Anbieterobjekts festlegt, kann er WdfWmiProviderGetTracingHandle aufrufen, um ein Ablaufverfolgungshandle abzurufen, nachdem ein Anbieter instance registriert wurde. Der Treiber kann das Ablaufverfolgungshandle als Eingabe für die WmiTraceMessage-Routine verwenden.
Weitere Informationen zur WdfWmiProviderGetTracingHandle-Methode finden Sie unter Unterstützung der WMI-Ereignisablaufverfolgung. Weitere Informationen zu WMI finden Sie unter Unterstützung von WMI in Framework-Based-Treibern.
Beispiele
Im folgenden Codebeispiel wird ein Handle für die Ereignisprotokollierung einer WPP-Ablaufverfolgungssitzung abgerufen.
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfwmi.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |