WdfWmiProviderGetTracingHandle-Funktion (wdfwmi.h)
[Gilt nur für KMDF]
Die WdfWmiProviderGetTracingHandle--Methode gibt ein Handle an den Ereignisprotokollierer einer WPP-Softwareablaufverfolgung Sitzung 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.
Rückgabewert
WdfWmiProviderGetTracingHandle gibt ein Handle an den Ereignisablaufverfolgungsprotokollierer zurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Wenn ein Treiber die WdfWmiProviderTracing- Flag im Flags Mitglied der WDF_WMI_PROVIDER_CONFIG Struktur des WMI-Anbieterobjekts festlegt, kann er WdfWmiProviderGetTracingHandle- aufrufen, um ein Ablaufverfolgungshandle abzurufen, nachdem eine Anbieterinstanz registriert wurde. Der Treiber kann das Ablaufverfolgungshandle als Eingabe für die WmiTraceMessage Routine verwenden.
Weitere Informationen zur WdfWmiProviderGetTracingHandle--Methode finden Sie unter Unterstützen der WMI-Ereignisablaufverfolgung. Weitere Informationen zu WMI finden Sie unter Unterstützen von WMI in Framework-Based Drivers.
Beispiele
Im folgenden Codebeispiel wird ein Handle für den Ereignisprotokollierer einer WPP-Ablaufverfolgungssitzung abgerufen.
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfwmi.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |