SpbRequestGetParameters 関数 (spbcx.h)

SpbRequestGetParameters メソッドは、I/O 要求から SPB 固有のパラメーター値のセットを取得します。

構文

void SpbRequestGetParameters(
  [in]  SPBREQUEST             SpbRequest,
  [out] SPB_REQUEST_PARAMETERS *Parameters
);

パラメーター

[in] SpbRequest

I/O 要求に対する SPBREQUEST ハンドル。 SPB コントローラー ドライバーは、登録されている イベント コールバック関数のいずれかを通じて、このハンドルを以前に受け取った。

[out] Parameters

メソッドが I/O 要求から SPB 固有のパラメーター値を書き込む呼び出し元によって割り当てられた SPB_REQUEST_PARAMETERS 構造体へのポインター。 呼び出し元は、 SPB_REQUEST_PARAMETERS_INIT 関数を呼び出すことによって、この構造体を以前に初期化しておく必要があります。

戻り値

なし

解説

SpbRequestGetParameters は WdfRequestGetParameters メソッドに似ていますが、SPB 固有の情報のみを取得します。 SPB コントローラー ドライバーは SpbRequestGetParameters を呼び出して、SPB フレームワーク拡張機能 (SpbCx) から受信した I/O 要求から SPB 固有の情報を取得できます。 SPB コントローラー ドライバーは 、WdfRequestGetParameters を呼び出して、受信した I/O 要求から汎用要求パラメーターを取得できます。

例

次のコード例は、 SpbRequestGetParameters を使用して、I/O 要求から SPB 固有のパラメーターを取得する方法を示しています。 spbRequest 変数には、I/O 要求に対する SPBREQUEST ハンドルが含まれています。

SPB_REQUEST_PARAMETERS parameters;

SPB_REQUEST_PARAMETERS_INIT(&parameters);

SpbRequestGetParameters(spbRequest, &parameters);

要件

こちらもご覧ください

SPBREQUEST

SPB_REQUEST_PARAMETERS

SPB_REQUEST_PARAMETERS_INIT

WdfRequestGetParameters