WDF_WMI_INSTANCE_CONFIG 结构 (wdfwmi.h)

项目
08/08/2023

[仅适用于 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 回调函数 (，除非实例数据是只读) 。

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

Register

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

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

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

EvtWmiInstanceSetItem

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

EvtWmiInstanceExecuteMethod

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