共用方式為

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錯誤碼。

規格需求

需求 值
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

IoWMIOpenBlock

WNODE_EVENT_ITEM