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