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，或者返回以下警告或错误代码之一：

返回代码 说明
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