Функция 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

Запросите к транспорту сведения о поставщике. При успешном выполнении в буфер pInformation копируется структура RXCE_TRANSPORT_PROVIDER_INFO. Обратите внимание, что RXCE_TRANSPORT_PROVIDER_INFO — это определение типа для TDI_PROVIDER_INFO.

RxCeConnectionInformation

Запрос Для получения сведений о подключении. Структура RXCE_CONNECTION_INFORMATION копируется в буфер pInformation при успешном выполнении. Обратите внимание, что RXCE_CONNECTION_INFORMATION — это определение типа для TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Запрос транспорта Для получения сведений о конечной точке подключения. Структура RXCE_CONNECTION_INFO копируется в буфер pInformation при успешном выполнении. Обратите внимание, что RXCE_CONNECTION_INFO — это определение типа для TDI_CONNECTION_INFO.

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

Для некоторых значений InformationClassRxCeQueryInformation вызывает TdiBuildQueryInformation и TDI для получения запрошенной информации.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть rxce.h (включая Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

См. также раздел

RxCeQueryAdapterStatus

RxCeQueryTransportInformation