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)

Weitere Informationen

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate