__RxFillAndInstallFastIoDispatch関数 (mrx.h)

[アーティクル]
10/13/2023

RxFillAndInstallFastIoDispatch は、通常のディスパッチ I/O ベクトルと同じ高速 I/O ディスパッチベクターを入力し、渡されたデバイスオブジェクトに関連付けられているドライバーオブジェクトにインストールします。

構文

void __RxFillAndInstallFastIoDispatch(
  [in]      IN PRDBSS_DEVICE_OBJECT  RxDeviceObject,
  [in, out] IN OUT PFAST_IO_DISPATCH FastIoDispatch,
  [in]      IN ULONG                 FastIoDispatchSize
);

パラメーター

[in] RxDeviceObject

このネットワークリダイレクターの RDBSS デバイスオブジェクトへのポインター。

[in, out] FastIoDispatch

入力して使用する高速 I/O ディスパッチテーブルへのポインター。

[in] FastIoDispatchSize

渡された高速 I/O ディスパッチテーブルのサイズ (バイト単位)。

戻り値

なし

解説

RxFillAndInstallFastIoDispatch ルーチンは、モノリシックドライバーと非モノリシックドライバーネットワークミニリダイレクターに対して異なる方法で実装されます。

非モノリシックネットワークミニリダイレクタードライバー (動的に rdbss.sys にリンクする Microsoft SMB リダイレクターなど) の場合、 RxFillAndInstallFastIoDispatch は、通常のディスパッチ I/O ベクターテーブルルーチンを高速 I/O ディスパッチベクターテーブルにコピーする便利なルーチンです。通常、このルーチンは、 RxRegisterMiniRdr を呼び出す前に高速 I/O ディスパッチテーブルに入力するために、非モノリシックネットワークミニリダイレクターによって使用されます。このルーチンでは、コピーするバイト数を決定するために、 FastIoDispatchSize パラメーターの最小値と ntifs.h で定義されているFAST_IO_DISPATCH構造体のサイズを使用します。

開発者によって構築されたモノリシックネットワークミニリダイレクターの場合、 RxFillAndInstallFastIoDispatch ルーチンは何も行いません。