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


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

Подпрограмма 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 подпрограммы обратного вызова указывает на значение, указанное в параметре контекста контекста подпрограммы IoWMISetNotificationCallback.

[in, optional] Context

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

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

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

Требования

Требование Ценность
целевая платформа Всеобщий
заголовка wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также

IoWMIOpenBlock

WNODE_EVENT_ITEM