IoWMISetNotificationCallback 函数 (wdm.h)
IoWMISetNotificationCallback 例程为 WMI 事件注册通知回调。
语法
NTSTATUS IoWMISetNotificationCallback(
[in, out] PVOID Object,
[in] WMI_NOTIFICATION_CALLBACK Callback,
[in, optional] PVOID Context
);
参数
[in, out] Object
指向 WMI 数据块对象的指针。 调用方使用 IoWMIOpenBlock 例程打开 WMI 事件的数据块对象。 必须使用WMIGUID_NOTIFICATION访问权限打开对象。
[in] Callback
指向窗体函数的指针:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
WMI 调用此函数以通知调用方已发生指定事件。 回调例程的 Wnode 参数指向触发事件的驱动程序返回 的WNODE_EVENT_ITEM 结构。 回调例程的 Context 参数指向 IoWMISetNotificationCallback 例程的 Context 参数中指定的值。
[in, optional] Context
指定发生事件时 WMI 传递给回调例程的值。
返回值
此例程在成功时返回STATUS_SUCCESS,在失败时返回相应的 NTSTATUS 错误代码。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |