WdfWmiProviderGetTracingHandle method

[Applies to KMDF only]

The WdfWmiProviderGetTracingHandle method returns a handle to the event logger of a WPP software tracing session.

Syntax


ULONGLONG WdfWmiProviderGetTracingHandle(
  [in]  WDFWMIPROVIDER WmiProvider
);

Parameters

WmiProvider [in]

A handle to a WMI provider object that the driver obtained by calling WdfWmiProviderCreate or WdfWmiInstanceGetProvider.

Return value

WdfWmiProviderGetTracingHandle returns a handle to the event tracing logger.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

If a driver sets the WdfWmiProviderTracing flag in the Flags member of the WMI provider object's WDF_WMI_PROVIDER_CONFIG structure, it can call WdfWmiProviderGetTracingHandle to obtain a tracing handle after a provider instance has been registered. The driver can use the tracing handle as input to the WmiTraceMessage routine.

For more information about the WdfWmiProviderGetTracingHandle method, see Supporting WMI Event Tracing. For more information about WMI, see Supporting WMI in Framework-Based Drivers.

Examples

The following code example obtains a handle to a WPP tracing session's event logger.


ULONGLONG tracingHandle;

tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);

Requirements

Minimum KMDF version

1.0

Header

Wdfwmi.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<=DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

See also

WDF_WMI_PROVIDER_CONFIG
WdfWmiInstanceGetProvider
WdfWmiProviderCreate

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft