función __RxFillAndInstallFastIoDispatch (mrx.h)

Artículo
10/13/2023

RxFillAndInstallFastIoDispatch rellena un vector de distribución de E/S rápido para que sea idéntico al vector de E/S de envío normal e lo instala en el objeto de controlador asociado al objeto de dispositivo pasado.

Sintaxis

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

Parámetros

[in] RxDeviceObject

Puntero al objeto de dispositivo RDBSS para este redirector de red.

[in, out] FastIoDispatch

Puntero a la tabla de distribución de E/S rápida para rellenar y usar.

[in] FastIoDispatchSize

Tamaño, en bytes, de la tabla de distribución de E/S rápida pasada.

Valor devuelto

None

Observaciones

La rutina RxFillAndInstallFastIoDispatch se implementa de forma diferente para los controladores monolíticos y no monolíticos de red minidirector.

Para los controladores de minidirector de red no monolíticos, como el redirector de SMB de Microsoft que se vincula a rdbss.sys dinámicamente, RxFillAndInstallFastIoDispatch es una rutina de conveniencia que copia las rutinas normales de tabla de vectores de E/S de envío a la tabla de vectores de distribución de E/S rápida. Normalmente, esta rutina la usaría un minidirector de red no monolítico para rellenar la tabla de distribución de E/S rápida antes de llamar a RxRegisterMiniRdr. Esta rutina usa el mínimo del parámetro FastIoDispatchSize y el tamaño de la estructura FAST_IO_DISPATCH definida en ntifs.h para determinar el número de bytes que se van a copiar.

Para los mini-redireccionadores monolíticos creados por los desarrolladores, la rutina RxFillAndInstallFastIoDispatch no hace nada.