função __RxFillAndInstallFastIoDispatch (mrx.h)

Artigo
02/26/2024

RxFillAndInstallFastIoDispatch preenche um vetor de expedição de E/S rápido para ser idêntico ao vetor de E/S de expedição normal e o instala no objeto de driver associado ao objeto de dispositivo passado.

Sintaxe

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

Parâmetros

[in] RxDeviceObject

Um ponteiro para o objeto de dispositivo RDBSS para esse redirecionador de rede.

[in, out] FastIoDispatch

Um ponteiro para a tabela de expedição de E/S rápida a ser preenchida e usada.

[in] FastIoDispatchSize

O tamanho, em bytes, da tabela de expedição de E/S rápida passada.

Retornar valor

Nenhum

Comentários

A rotina RxFillAndInstallFastIoDispatch é implementada de forma diferente para o minidiretório de rede de drivers monolíticos e não monolíticos.

Para drivers de minidiretório de rede não monolíticos, como o redirecionador SMB da Microsoft que se vincula a rdbss.sys dinamicamente, RxFillAndInstallFastIoDispatch é uma rotina de conveniência que copia as rotinas normais de tabela de vetor de E/S de expedição para a tabela de vetor de expedição de E/S rápida. Normalmente, essa rotina seria usada por um minidiretório de rede não monolítico para preencher a tabela de expedição de E/S rápida antes de chamar RxRegisterMiniRdr. Essa rotina usa o mínimo do parâmetro FastIoDispatchSize e o tamanho da estrutura de FAST_IO_DISPATCH definida em ntifs.h para determinar o número de bytes a serem copiados.

Para minidiretórios de rede monolíticos criados por desenvolvedores, a rotina RxFillAndInstallFastIoDispatch não faz nada.