Функция IoWMISetNotificationCallback (wdm.h)

Статья
03/08/2023

Подпрограмма IoWMISetNotificationCallback регистрирует обратный вызов уведомления для события WMI.

Синтаксис

NTSTATUS IoWMISetNotificationCallback(
  [in, out]      PVOID                     Object,
  [in]           WMI_NOTIFICATION_CALLBACK Callback,
  [in, optional] PVOID                     Context
);

Параметры

[in, out] Object

Указатель на объект блока данных WMI. Вызывающий объект открывает объект блока данных для события WMI с помощью процедуры IoWMIOpenBlock . Объект должен быть открыт с правом доступа WMIGUID_NOTIFICATION.

[in] Callback

Указатель на функцию формы:

 XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);

WMI вызывает эту функцию для уведомления вызывающей стороны о том, что произошло указанное событие. Параметр Wnode подпрограммы обратного вызова указывает на структуру WNODE_EVENT_ITEM , возвращаемую драйвером, запускающим событие. Параметр Context подпрограммы обратного вызова указывает на значение, указанное в параметре Context подпрограммы IoWMISetNotificationCallback .

[in, optional] Context

Указывает значение, которое WMI передает подпрограмме обратного вызова при возникновении события.

Возвращаемое значение

Эта подпрограмма возвращает STATUS_SUCCESS при успешном выполнении и соответствующий код ошибки NTSTATUS при сбое.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также раздел

IoWMIOpenBlock

WNODE_EVENT_ITEM

Поделиться через