RxCeQueryInformation 函式 (rxce.h)

RxCeQueryInformation 會查詢呼叫端配置緩衝區中聯機的相關信息。

語法

NTSTATUS RxCeQueryInformation(
  [in]  IN PRXCE_VC                          pVc,
  [in]  IN RXCE_CONNECTION_INFORMATION_CLASS InformationClass,
  [out] OUT PVOID                            pInformation,
  [in]  IN ULONG                             Length
);

參數

[in] pVc

與此聯機相關聯的虛擬線路指標。

[in] InformationClass

此查詢類型的所需信息類別。 針對 InformationClass 指定的值會決定傳回的信息類型。 此參數是在 rxcehdlr.h 中定義的列舉，可以是下列其中一個值：

RxCeTransportProviderInformation

查詢傳輸中的提供者資訊。 RXCE_TRANSPORT_PROVIDER_INFO 結構會在成功時複製到 pInformation 緩衝區。 請注意，RXCE_TRANSPORT_PROVIDER_INFO是TDI_PROVIDER_INFO的 typedef。

RxCeConnectionInformation

查詢連線的相關信息。 RXCE_CONNECTION_INFORMATION 結構會在成功時複製到 pInformation 緩衝區。 請注意，RXCE_CONNECTION_INFORMATION是 TDI_CONNECTION_INFORMATION 的 typedef。

RxCeConnectionEndpointInformation

查詢傳輸 如需連線端點的相關信息。 RXCE_CONNECTION_INFO 結構會在成功時複製到 pInformation 緩衝區。 請注意，RXCE_CONNECTION_INFO是TDI_CONNECTION_INFO的 typedef。

RxCeRemoteAddressInformation

查詢傳輸 如需遠端位址的相關信息。 TDI_ADDRESS_INFO 結構會在成功時複製到 pInformation 緩衝區。

[out] pInformation

呼叫端提供的緩衝區，用於傳回資訊。

[in] Length

緩衝區的長度。

傳回值

RxCeQueryInformation 會在成功或下列其中一個警告或錯誤碼時傳回STATUS_SUCCESS：

傳回碼	Description
STATUS_BUFFER_OVERFLOW	pInformation 所指向的輸出緩衝區長度不夠大，無法接收 InformationClass 查詢類型所要求的資訊。
STATUS_INSUFFICIENT_RESOURCES	此例程所需的非分頁集區內存配置失敗。
STATUS_INVALID_PARAMETER	下列任何條件都可以傳回此值： 傳遞至此例程的 pVC 參數無效。 為此虛擬線路定義的連線、位址或傳輸無效。 此查詢類型的 InformationClass 不是其中一個允許的值。

備註

RxCeQueryInformation 會傳回指定虛擬線路的資訊。 呼叫 RxCeQueryInformation 時可以指定之 InformationClass 的唯一值如下：

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

對於 InformationClass 的某些值， RxCeQueryInformation 會呼叫 TdiBuildQueryInformation 和 TDI 來擷取要求的資訊。

規格需求

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

另請參閱

RxCeQueryAdapterStatus

RxCeQueryTransportInformation