__RxFillAndInstallFastIoDispatch-Funktion (mrx.h)

Artikel
02/07/2025

RxFillAndInstallFastIoDispatch füllt einen schnellen E/A-Verteilervektor aus, um mit dem normalen Verteiler-E/A-Vektor identisch zu sein und es in das treiberobjekt zu installieren, das dem übergebenen Geräteobjekt zugeordnet ist.

Syntax

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

Parameter

[in] RxDeviceObject

Ein Zeiger auf das RDBSS-Geräteobjekt für diesen Netzwerkumleitungsmodul.

[in, out] FastIoDispatch

Ein Zeiger auf die schnelle E/A-Verteilertabelle, um sie auszufüllen und zu verwenden.

[in] FastIoDispatchSize

Die Größe der schnell übergebenen E/A-Verteilertabelle in Bytes.

Rückgabewert

Nichts

Bemerkungen

Die RxFillAndInstallFastIoDispatch Routine wird für monolithische und nicht-monolithische Treiber-Miniumleitungen unterschiedlich implementiert.

Bei nicht-monolithischen Netzwerk-Miniumleitungstreibern, z. B. dem Microsoft SMB-Umleitungstreiber, der dynamisch mit rdbss.sys verknüpft ist, ist RxFillAndInstallFastIoDispatch eine Komfortroutine, die die normalen E/A-Vektortabellenroutinen des Versands in die schnelle E/A-Verteilervektortabelle kopiert. Diese Routine würde normalerweise von einem nicht-monolithischen Netzwerk-Miniumleitung verwendet werden, um die schnelle E/A-Verteilertabelle auszufüllen, bevor RxRegisterMiniRdraufgerufen wird. Diese Routine verwendet das Minimum der FastIoDispatchSize Parameter und die Größe der in ntifs.h definierten FAST_IO_DISPATCH-Struktur, um die Anzahl der zu kopierenden Bytes zu bestimmen.

Für monolithische Netzwerk-Miniumleitungen, die von Entwicklern erstellt wurden, erledigt die RxFillAndInstallFastIoDispatch Routine nichts.