структура 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

Дескриптор объекта поставщика WMI, полученный драйвером, вызывающим WdfWmiProviderCreate. Если этот элемент 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.

Замечания

Структура WDF_WMI_INSTANCE_CONFIG используется в качестве входных данных для метода WdfWmiInstanceCreate.

Чтобы инициализировать структуру WDF_WMI_INSTANCE_CONFIG, драйвер должен вызывать WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER или WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG.