WmiSystemControl 関数 (wmilib.h)

[アーティクル]
03/05/2024

WmiSystemControl ルーチンは、WMI ライブラリサポートルーチンを使用して WMI IRP を処理するドライバーのディスパッチルーチンです。

構文

NTSTATUS WmiSystemControl(
  [in]      PWMILIB_CONTEXT         WmiLibInfo,
  [in]      PDEVICE_OBJECT          DeviceObject,
  [in, out] PIRP                    Irp,
  [out]     PSYSCTL_IRP_DISPOSITION IrpDisposition
);

パラメーター

[in] WmiLibInfo

ドライバーのデータブロックとイベントブロックの登録情報を格納し、ドライバーの WMI ライブラリコールバックルーチンのエントリポイントを定義する WMILIB_CONTEXT構造体へのポインター。

[in] DeviceObject

ドライバーの DEVICE_OBJECTへのポインター。

[in, out] Irp

IRP へのポインター。

[out] IrpDisposition

IRP の処理方法を示す SYSCTL_IRP_DISPOSITION 型の列挙値へのポインター。 WmiSystemControl は 、成功しない NTSTATUS コードを返す場合でも、常にこの値を設定します。

SYSCTL_IRP_DISPOSITION は Wmilib.h の列挙であり、次の値が含まれています。

IrpProcessed

IRP が処理され、完了した可能性があります。 WmiSystemControl によって呼び出されたドライバーの DpWmiXxx ルーチンが IRP を完了しなかった場合、ドライバーは WmiCompleteRequest を呼び出して、WmiSystemControl が返された後に IRP を完了する必要があります。

IrpNotCompleted

WMI がエラーを検出し、適切なエラーコードで IRP を設定したか、 IRP_MN_REGINFOまたはIRP_MN_REGINFO_EX 要求を処理したため、IRP は処理されましたが、完了していません。ドライバーは、IoCompleteRequest を呼び出して IRP を完了する必要があります。

IrpNotWmi

IRP は WMI 要求ではありません (つまり、WMI は IRP のマイナーコードを認識しません)。ドライバーは、このIRP_MN_XXX でIRP_MJ_SYSTEM_CONTROL要求を処理する場合は、IRP を処理する必要があります。それ以外の場合、ドライバーは IRP を次の下位ドライバーに転送する必要があります。ドライバーが最下位レベルのドライバーである場合は、IRP を完了する必要があります。

IrpForward

IRP は別のデバイスオブジェクトを対象としています (つまり、IRP の Parameters.WMI.ProviderId にあるデバイスオブジェクトポインターが、 IoWMIRegistrationControl の呼び出しでドライバーによって渡されたポインターと一致しません)。ドライバーは、次の下位ドライバーに IRP を転送する必要があります。ドライバーが最下位レベルのドライバーである場合は、IRP を完了する必要があります。

戻り値

WmiSystemControl は 、STATUS_SUCCESSまたは次のいずれかのエラーコードを返します。

注釈

ドライバーは、WMI IRP マイナーコードを使用してIRP_MJ_SYSTEM_CONTROL要求を受信すると、ドライバーのWMILIB_CONTEXT構造体へのポインター、そのデバイスオブジェクトへのポインター、および IRP へのポインターを使用して WmiSystemControl を呼び出します。 WMILIB_CONTEXT構造体には、ドライバーのデータブロックとイベントブロックの登録情報が含まれており、WMI ライブラリコールバックルーチンのエントリポイントを定義します。

WmiSystemControl は、IRP が WMI 要求であることを確認し、要求で指定されたブロックがドライバーに対して有効かどうかを判断します。その場合は、ドライバーのWMILIB_CONTEXT構造で適切な DpWmiXxx エントリポイントを呼び出すことによって IRP を処理します。 WMI は、ドライバーの DpWmiXxx ルーチンを呼び出すときに、IRQL PASSIVE_LEVELで実行されています。

ドライバーは、次の下位ドライバーにIRP_MJ_SYSTEM_CONTROL要求を転送するときに、IRQL PASSIVE_LEVEL で実行されている必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	wmilib.h (Wmilib.h を含む)
Library	Wmilib.lib
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則	WmiComplete(wdm)