Share via

Функция RxCeBuildTransport (rxce.h)

  • Статья

RxCeBuildTransport привязывает объект транспорта RDBSS к указанному имени транспорта.

Синтаксис

NTSTATUS RxCeBuildTransport(
       IN PRXCE_TRANSPORT pRxCeTransport,
  [in] IN PUNICODE_STRING pTransportName,
  [in] IN ULONG           QualityOfService
);

Параметры

pRxCeTransport

Во входных данных этот параметр содержит указатель на неинициализированный транспорт RDBSS, с которым необходимо связать это имя транспорта. В выходных данных при успешном вызове транспорт связывается с указанным именем транспорта и транспорт правильно инициализируется.

[in] pTransportName

Указатель на строку привязки Юникода для нужного транспорта.

[in] QualityOfService

Качество обслуживания, требуемое от транспорта.

Возвращаемое значение

RxCeBuildTransport возвращает STATUS_SUCCESS при успешном выполнении или один из следующих кодов ошибок при сбое:

Код возврата Описание
STATUS_INSUFFICIENT_RESOURCES
 Не удалось выделить непагрегированную память пула, необходимую для этой подпрограммы.
STATUS_INVALID_PARAMETER
 Один из параметров, переданных в эту подпрограмму, был недопустимым.

Комментарии

При успешном выполнении RxCeBuildTransport элементы данных в структуре RXCE_TRANSPORT, на которую указывает параметр pTransport , будут правильно инициализированы, а транспорт RDBSS будет привязан к указанному транспорту TDI.

Подпрограммы подсистемы подключения в RDBSS не участвуют в вычислении качества обслуживания. RDBSS использует параметр QualityOfService в качестве магического числа, передаваемого базовому поставщику транспорта.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть rxce.h (включая Rxce.h)
IRQL <= APC_LEVEL

См. также раздел

RxCeTearDownTransport