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 错误代码。

要求

另请参阅

IoWMIOpenBlock

WNODE_EVENT_ITEM