Edit

WDF_WMI_PROVIDER_FLAGS enumeration (wdfwmi.h)

  • Article

[Applies to KMDF only]

The WDF_WMI_PROVIDER_FLAGS enumeration defines configuration flags for a driver's WMI data provider.

Syntax

typedef enum _WDF_WMI_PROVIDER_FLAGS {
  WdfWmiProviderEventOnly = 0x0001,
  WdfWmiProviderExpensive = 0x0002,
  WdfWmiProviderTracing = 0x0004,
  WdfWmiProviderValidFlags = WdfWmiProviderEventOnly | WdfWmiProviderExpensive | WdfWmiProviderTracing
} WDF_WMI_PROVIDER_FLAGS;

Constants

 
WdfWmiProviderEventOnly
Value: 0x0001
WMI clients can receive notification of WMI events, but they cannot query or set instance data. The driver can call WdfWmiInstanceFireEvent, but it does not provide any instance-specific callback functions.
WdfWmiProviderExpensive
Value: 0x0002
Collecting the provider's data can potentially affect the driver's performance, so the driver will not collect data unless a WMI client has registered to use it. The framework calls the driver's EvtWmiProviderFunctionControl callback function, passing the WdfWmiInstanceControl value (from the WDF_WMI_PROVIDER_CONTROL enumeration), to inform the driver to begin collecting data. If the driver does not provide an EvtWmiProviderFunctionControl callback function, it can call WdfWmiProviderIsEnabled.
WdfWmiProviderTracing
Value: 0x0004
The WMI data provider supports WMI event tracing. The driver can obtain the tracing handle by calling WdfWmiProviderGetTracingHandle. If this flag is set, no other flags can be set.
WdfWmiProviderValidFlags
Value: WdfWmiProviderEventOnly
The bitwise OR of all flags. Drivers should not use this value.

Remarks

The WDF_WMI_PROVIDER_FLAGS enumeration is used in the WDF_WMI_PROVIDER_CONFIG structure.

Requirements

Requirement Value
Minimum KMDF version 1.0
Header wdfwmi.h (include Wdf.h)

See also

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceControl

WdfWmiInstanceFireEvent

WdfWmiProviderGetTracingHandle

WdfWmiProviderIsEnabled