RxCeQueryAdapterStatus 函式 (rxce.h)

RxCeQueryAdapterStatus 會傳回呼叫端配置緩衝區中指定傳輸的ADAPTER_STATUS結構。

語法

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

pTransport

與配接器相關聯的 RDBSS 傳輸指標。

pAdapterStatus

在輸入時，此參數包含呼叫端配置緩衝區的指標，以保存配接器狀態。當此呼叫成功時，緩衝區會包含與指定 RDBSS 傳輸相關聯的配接器狀態。

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

傳回碼	Description
STATUS_ADDRESS_NOT_ASSOCIATED	適配卡位址未與 RDBSS 傳輸相關聯。
STATUS_INSUFFICIENT_RESOURCES	此例程所需的非分頁集區內存配置失敗。
STATUS_INVALID_PARAMETER	傳遞至此例程的 pTransport 參數無效。

RxCeQueryAdapterStatus 會傳回指定傳輸的ADAPTER_STATUS結構。此例程最常用來取得配接器的 NetBIOS 名稱。

RxCeQueryAdapterStatus 會使用TDI_QUERY_ADAPTER_STATUS查詢呼叫 TdiBuildQueryInformation 。