__RxFillAndInstallFastIoDispatch函式 (mrx.h)

發行項
03/05/2024

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 例程不會執行任何動作。