Функция RxCeQueryInformation (rxce.h)

Статья
08/07/2023

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 для этого типа запроса не был одним из допустимых значений.

Требования

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

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

RxCeQueryAdapterStatus

RxCeQueryTransportInformation

Share via