RxCeBuildTransport 函式 (rxce.h)

  • 發行項

RxCeBuildTransport 會將 RDBSS 傳輸物件系結至指定的傳輸名稱。

語法

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

參數

pRxCeTransport

在輸入時，此參數包含與此傳輸名稱相關聯的未初始化 RDBSS 傳輸指標。 當此呼叫成功時，在輸出中，傳輸會與指定的傳輸名稱相關聯，且傳輸已正確初始化。

[in] pTransportName

所需傳輸之 Unicode 系結字串的指標。

[in] QualityOfService

傳輸所需的服務品質。

傳回值

RxCeBuildTransport 會在成功時傳回STATUS_SUCCESS，或在失敗時傳回下列其中一個錯誤碼：

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES
 此例程所需的非分頁集區內存配置失敗。
STATUS_INVALID_PARAMETER
 傳遞至此例程的其中一個參數無效。

備註

當 RxCeBuildTransport 成功時， pTransport 參數所指向之RXCE_TRANSPORT結構中的數據成員將會正確初始化，而 RDBSS 傳輸將會系結至指定的 TDI 傳輸。

RDBSS 中的連線引擎例程不會參與服務質量的計算。 RDBSS 基本上會使用 QualityOfService 參數作為傳遞至基礎傳輸提供者的魔術編號。

規格需求

需求 值
目標平台 桌面
標頭 rxce.h (包含 Rxce.h)
IRQL <= APC_LEVEL

另請參閱

RxCeTearDownTransport