функция обратного вызова EVT_WDF_WMI_INSTANCE_SET_ITEM (wdfwmi.h)
[Применимо только к KMDF]
Функция обратного вызова драйвера EvtWmiInstanceSetItem задает для одного элемента данных экземпляра поставщика данных WMI значение, которое предоставляет клиент WMI.
Синтаксис
EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;
NTSTATUS EvtWdfWmiInstanceSetItem(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG DataItemId,
[in] ULONG InBufferSize,
[in] PVOID InBuffer
)
{...}
Параметры
[in] WmiInstance
Дескриптор объекта экземпляра WMI.
[in] DataItemId
Значение, определяющее элемент данных для экземпляра поставщика. Это значение соответствует значению WmiDataId, указанному в MOF-файле поставщика.
[in] InBufferSize
Размер в байтах входного буфера, на который InBuffer указывает.
[in] InBuffer
Указатель на входной буфер.
Возвращаемое значение
Функция обратного вызова EvtWmiInstanceSetItem должна возвращать STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта функция должна возвращать значение состояния, для которого NT_SUCCESS(состояние) равно FALSE. Если входной буфер, который InBuffer указывает на слишком мал, чтобы содержать все данные, которые ожидает драйвер, функция обратного вызова должна возвращать STATUS_WMI_SET_FAILURE.
Замечания
Чтобы зарегистрировать функцию обратного вызова EvtWmiInstanceSetItem, драйвер должен поместить адрес функции в структуру WDF_WMI_INSTANCE_CONFIG перед вызовом WdfWmiInstanceCreate.
Платформа не синхронизирует вызовы функций обратного вызова событий WMI драйвера друг с другом или с любыми другими функциями обратного вызова событий драйвера. Если данные функции обратного вызова EvtWmiInstanceSetItem динамически и совместно используют другие функции обратного вызова, драйвер может использовать ожидания платформы или блокировки спина для синхронизации доступа к данным.
Дополнительные сведения о функции обратного вызова EvtWmiInstanceSetIte m см. в поддержке WMI в драйверах Framework-Based.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.0 |
| заголовка | wdfwmi.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |