ScsiPortWmiDispatchFunction 関数 (scsiwmi.h)

[アーティクル]
08/07/2023

ScsiPortWmiDispatchFunction ルーチンは、WMI をサポートするミニポートドライバーのディスパッチルーチンです。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーモデルと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

BOOLEAN ScsiPortWmiDispatchFunction(
  [in] PSCSI_WMILIB_CONTEXT     WmiLibInfo,
  [in] UCHAR                    MinorFunction,
  [in] PVOID                    DeviceContext,
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [in] PVOID                    DataPath,
  [in] ULONG                    BufferSize,
  [in] PVOID                    Buffer
);

パラメーター

[in] WmiLibInfo

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

[in] MinorFunction

実行する WMI アクションを示します。ミニポートドライバーは、入力 SRB から Srb-WmiSubFunction> に MinorFunction を設定します。

[in] DeviceContext

ミニポートドライバーで定義されたコンテキスト値へのポインター。ポートドライバーは、ミニポートドライバーの HwScsiWmiXxx コールバックルーチンに DeviceContext を渡します。この値は通常、HW_DEVICE_EXTENSION構造体を指します。

[in] RequestContext

WMI SRB のコンテキスト情報を含むSCSIWMI_REQUEST_CONTEXT構造体へのポインター。 SRB にペンを設定できる場合、要求コンテキストは ScsiPortWmiPostProcess が最終的な SRB の戻り状態とバッファーサイズを返すまで有効なままにする必要があるため、ミニポートドライバーは SRB 拡張機能からこの構造体を割り当てる必要があります。 ScsiPortWmiDispatchFunction は、この要求を処理するミニポートドライバーのコールバックルーチンに RequestContext を渡します。

[in] DataPath

要求に関連付けられているデータブロックを表す GUID へのポインター。ミニポートドライバーは、 入力 SRB から Srb-DataPath> に DataPath を設定します。

[in] BufferSize

データバッファーのサイズをバイト単位で指定します。ミニポートドライバーは、入力 SRB から Srb-DataTransferLength> に BufferSize を設定します。

[in] Buffer

データバッファーへのポインター。ミニポートドライバーは、入力 SRB から Srb-DataBuffer> にバッファーを設定します。

戻り値

ScsiPortWmiDispatchFunction は、要求が保留中の場合は TRUE 、要求が完了した場合は FALSE を 返します。

注釈

ミニポートドライバーは、関数メンバーがSRB_FUNCTION_WMIに設定されている SRB を受信すると、初期化されたSCSI_WMILIB_CONTEXT構造体へのポインターを含む要求パラメーターを使用して ScsiPortWmiDispatchFunction を呼び出します。この構造体には、ミニポートドライバーのデータブロックとイベントブロックに関する情報が含まれており、ミニポートドライバーの HwScsiWmiXxx コールバックルーチンのエントリポイントを定義します。

ScsiPortWmiDispatchFunction は、SRB が WMI 要求であることを確認し、要求で指定されたブロックがミニポートドライバーに対して有効かどうかを判断します。これらの条件が満たされた場合、 ScsiPortWmiDispatchFunction は、ミニポートドライバーのSCSI_WMILIB_CONTEXT構造体の適切な HwScsiWmiXxx エントリポイントを呼び出すことによって SRB を処理します。ミニポートドライバーがオプションの HwScsiWmiXxx ルーチンのエントリポイントを定義していない場合、ポートドライバーは要求を処理します。

どちらの場合も、 ScsiPortWmiDispatchFunction が返された後、ミニポートドライバーは、ペンドされていない要求に対して次の操作を行う必要があります。

Srb->DataTransferLength を ScsiPortWmiGetReturnSize によって返される値に設定します
Srb->SrbStatus を ScsiPortWmiGetReturnStatus によって返される値に設定します
RequestComplete を使用して ScsiPortNotification を呼び出し、NextRequest でもう一度呼び出す