次の方法で共有


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 を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

IoWMIOpenBlock

WNODE_EVENT_ITEM