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