__RxFillAndInstallFastIoDispatch function (mrx.h)

Article
10/12/2023

RxFillAndInstallFastIoDispatch fills out a fast I/O dispatch vector to be identical with the normal dispatch I/O vector and installs it into the driver object associated with the device object passed.

Syntax

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

Parameters

[in] RxDeviceObject

A pointer to the RDBSS device object for this network redirector.

[in, out] FastIoDispatch

A pointer to the fast I/O dispatch table to fill in and use.

[in] FastIoDispatchSize

The size, in bytes, of the fast I/O dispatch table passed.

Return value

None

Remarks

The RxFillAndInstallFastIoDispatch routine is implemented differently for monolithic and non-monolithic drivers network mini-redirector.

For non-monolithic network mini-redirector drivers, such as the Microsoft SMB redirector that links to rdbss.sys dynamically, RxFillAndInstallFastIoDispatch is a convenience routine that copies the normal dispatch I/O vector table routines to the fast I/O dispatch vector table. This routine would normally be used by a non-monolithic network mini-redirector to fill out the fast I/O dispatch table before calling RxRegisterMiniRdr. This routine uses the minimum of the FastIoDispatchSize parameter and the size of the FAST_IO_DISPATCH structure defined in ntifs.h to determine the number of bytes to copy.

For monolithic network mini-redirectors built by developers, the RxFillAndInstallFastIoDispatch routine does nothing.

Requirements

Requirement	Value
Target Platform	Desktop
Header	mrx.h (include Mrx.h)
IRQL	<= APC_LEVEL