Функция 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 |