структура WDF_WMI_INSTANCE_CONFIG (wdfwmi.h)
[Применяется только к 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 (если только данные экземпляра не доступны только для записи).
Если параметр UseContextForQuery имеет значение TRUE, данные экземпляра должны быть доступны только для чтения, поэтому драйвер не может предоставлять функции обратного вызова 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.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfwmi.h (включая Wdf.h) |
См. также раздел
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER