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

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

Синтаксис

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

Параметры

pRxCeTransport

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

[in] pTransportName

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

[in] QualityOfService

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

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

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

Возвращаемый код Описание
STATUS_INSUFFICIENT_RESOURCES
Сбой выделения памяти непагрегированного пула, необходимой для этой подпрограммы.
STATUS_INVALID_PARAMETER
Один из параметров, переданных этой подпрограмме, недопустим.

Замечания

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

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

Требования

Требование Ценность
целевая платформа Настольный
заголовка rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

См. также

RxCeTearDownTransport