WDF_WMI_INSTANCE_CONFIG结构（wdfwmi.h）

项目
02/07/2025

[仅适用于 KMDF]

WDF_WMI_INSTANCE_CONFIG 结构包含 WMI 数据提供程序实例的配置信息。

语法

typedef struct _WDF_WMI_INSTANCE_CONFIG {
  ULONG                               Size;
  WDFWMIPROVIDER                      Provider;
  PWDF_WMI_PROVIDER_CONFIG            ProviderConfig;
  BOOLEAN                             UseContextForQuery;
  BOOLEAN                             Register;
  PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWmiInstanceQueryInstance;
  PFN_WDF_WMI_INSTANCE_SET_INSTANCE   EvtWmiInstanceSetInstance;
  PFN_WDF_WMI_INSTANCE_SET_ITEM       EvtWmiInstanceSetItem;
  PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWmiInstanceExecuteMethod;
} WDF_WMI_INSTANCE_CONFIG, *PWDF_WMI_INSTANCE_CONFIG;

成员

Size

此结构的大小（以字节为单位）。

Provider

通过调用 WdfWmiProviderCreate获取的驱动程序的 WMI 提供程序对象的句柄。如果此成员 NULL，则 ProviderConfig 成员不得 NULL。

ProviderConfig

指向 WDF_WMI_PROVIDER_CONFIG 结构的指针。如果此成员 NULL，则 提供程序 成员不得 NULL。

UseContextForQuery

一个布尔值，如果 TRUE，则指示驱动程序将实例数据存储在 WMI 实例对象的上下文空间中，并且不会提供 EvtWmiInstanceQueryInstance 回调函数。相反，框架将通过将上下文空间的内容发送到 WMI 来为 WMI 客户端请求实例数据提供服务。如果此成员 FALSE，驱动程序必须提供 EvtWmiInstanceQueryInstance 回调函数（除非实例数据为仅写）。

如果 UseContextForQueryTRUE，则实例数据必须是只读的，因此驱动程序无法提供 EvtWmiInstanceSetInstance 或 EvtWmiInstanceSetItem 回调函数。

Register

一个布尔值，如果 TRUE，则表示框架将在创建 WMI 实例对象后向系统的 WMI 服务注册提供程序实例。如果此成员 FALSE，驱动程序必须调用 WdfWmiInstanceRegister 来注册提供程序实例。

EvtWmiInstanceQueryInstance

指向提供程序实例的驱动程序 EvtWmiInstanceQueryInstance 回调函数的指针，或 NULL。

EvtWmiInstanceSetInstance

指向提供程序实例的驱动程序 EvtWmiInstanceSetInstance 回调函数的指针，或 NULL。

EvtWmiInstanceSetItem

指向提供程序实例的驱动程序 EvtWmiInstanceSetItem 回调函数的指针，或 NULL。

EvtWmiInstanceExecuteMethod

指向提供程序实例的驱动程序 EvtWmiInstanceExecuteMethod 回调函数的指针，或 NULL。