IRP_MN_ENABLE_COLLECTION

  • [アーティクル]

データ ブロックの 1 つ以上を、収集に時間がかかる、またはコストがかかる可能性があるとして登録する WMI ドライバは、この IRP を処理する必要があります。 ドライバーは、「WMI 要求の処理」で説明されているように、WmiSystemControl を呼び出すか、ドライバー自身で IRP を処理することによって、WMI IRP を処理できます。

ドライバーが IRP_MN_ENABLE_COLLECTION 要求を処理するために WmiSystemControl を呼び出すと、WMI はそのドライバーの DpWmiFunctionControl ルーチンを呼び出します。

主要なコード

IRP_MJ_SYSTEM_CONTROL

送信時

WMI は、この IRP を送信して、ドライバーが収集コストが高いとして登録したデータ ブロックのデータの蓄積を開始するように、ドライバーに要求します。

WMI は任意のスレッド コンテキストで、IRQL = PASSIVE_LEVEL でこの IRP を送信します。

入力パラメーター

Parameters.WMI.ProviderId は、要求に応答する必要があるドライバーのデバイス オブジェクトを指します。 このポインターは、IRP のドライバーの I/O スタックの場所にあります。

Parameters.WMI.DataPath は、データが蓄積されるデータ ブロックを識別する GUID を指します。

出力パラメーター

なし。

I/O 状態ブロック

ドライバーが WmiSystemControl を呼び出して IRP を処理する場合、WMI は I/O 状態ブロックで Irp->IoStatus.Status と Irp->IoStatus.Information を設定します。

それ以外の場合、ドライバーは Irp->IoStatus.Status を STATUS_SUCCESS または次のような適切なエラー状態に設定します。

STATUS_WMI_GUID_NOT_FOUND

STATUS_INVALID_DEVICE_REQUEST

成功した場合、ドライバーは Irp->IoStatus.Information を 0 に設定します。

操作

ドライバーは、WMIREGGUID または WMIGUIDREGINFO 構造体の Flags メンバーに WMIREG_FLAG_EXPENSIVE を設定することによって、収集するコストの高いデータ ブロックを登録します。 ドライバーは、データ ブロックを登録または更新するときに、これらの構造体を WMI に渡します。 ドライバーは、データ収集を開始する明示的な要求を受け取るまで、このようなブロックのデータを蓄積する必要はありません。

ドライバーは、「WMI 要求の処理」で説明されているように、WmiSystemControl を呼び出すか、ドライバー自身で IRP を処理することによって、WMI IRP を処理できます。

ドライバーが WmiSystemControl を呼び出して WMI IRP を処理する場合、そのルーチンは、ドライバーの DpWmiFunctionControl ルーチンを呼び出すか、ドライバーがルーチンを定義していない場合は STATUS_SUCCESS を返します。

ドライバー自身が IRP_MN_ENABLE_COLLECTION 要求を処理する場合については、Parameters.WMI.ProviderId が、ドライバーが IoWMIRegistrationControl に渡したポインターと同じデバイス オブジェクトを指している場合にのみ、ドライバーがこの処理を行う必要があります。 それ以外の場合、ドライバーは、次の下位ドライバーに要求を転送する必要があります。

要求を処理する前に、ドライバーは Parameters.WMI.DataPath がドライバーがサポートする GUID を指していることを確認する必要があります。 指してない場合、ドライバーは IRP に失敗し、STATUS_WMI_GUID_NOT_FOUND を返す必要があります。 データ ブロックが有効であっても、WMIREG_FLAG_EXPENSIVE に登録されていない場合、ドライバーは STATUS_SUCCESS を返し、それ以上のアクションを実行しません。

ブロックが有効で、WMIREG_FLAG_EXPENSIVE に登録されている場合は、ドライバーは、そのデータ ブロックのすべてのインスタンスのデータ収集を有効にします。

ドライバーは、データ 収集がすでにデータ ブロックに対して有効になっているかどうかをチェックする必要があります。 WMI は、最初のデータ コンシューマーがブロックを有効にした後、データ ブロックを有効にするための要求を 1 つだけ送信します。 WMI は、無効化要求が介入しない限り、別の有効化の要求を送信しません。

要件

ヘッダー

 Wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

関連項目

DpWmiFunctionControl

IoWMIRegistrationControl

IRP_MN_DISABLE_COLLECTION

WMILIB_CONTEXT

WMIREGGUID

WmiSystemControl