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 エラー コードを返します。

要件

要件 値
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL

こちらもご覧ください

IoWMIOpenBlock

WNODE_EVENT_ITEM