TdiBuildQueryInformation

VOID
   TdiBuildQueryInformation (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN UINT QType,
       IN PMDL MdlAddr
      );

TdiBuildQueryInformation 함수는 로컬 클라이언트가 주소, 연결 엔드포인트, 통제 채널을 구현하는 장치 객체를 이미 연 하부의 트랜스포트로 TDI_QUERY_INFORMATION 리퀘스트를 위해서 내부 장치 통제 IRP를 설정한다.

매개변수

Irp

더 상위 레벨의 네트웍 컴포넌트에서 발생하거나 TdiBuildInternalDeviceControlIrp 함수를 가지고 할당된 클라이언트 제공 IRP를 가리킨다.

DevObj

하부 TDI 트랜스포트 드라이버에 의해서 생성된 장치 객체를 가리킨다.

FileObj

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 가리킨다.

CompRoutine

클라이언트 제공 IoCompletion 루틴의 엔트리 포인트를 서술하거나 NULL이다. 클라이언트가 이 매개변수를 NULL로 설정하지 않는다면 주어진 IRP가 완료될 때 I/O 매니저는 이 루틴을 호출한다.

Contxt

클라이언트 결졍 컨텍스트를 가리킨다. 이 클라이언트 제공 포인터는 완료된 IRP를 가지고 호출될 때 IoCompletion 루틴으로 전달된다. CompRoutine이 NULL이면 Contxt는 NULL이다.

QType

클라이언트가 무엇을 쿼리하는지를 서술한다. 이 매개변수는 모든 트랜스포트가 지원하는 쿼리에 대해서 다음의 시스템 정의 값이거나 트랜스포트 정의 값이다:

TDI_QUERY_ADDRESS_INFO: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_ADDRESS_INFO 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 트랜스포트 주소를 구현하거나 트랜스포트 주소와 이미 연관된 연결 엔드포인트를 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_CONNECTION_INFO: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_CONNECTION_INFO 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 연결 엔드포인트를 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_BROADCAST_ADDRESS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TRANSPORT_ADDRESS 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_NETWORK_ADDRESS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TRANSPORT_ADDRESS 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_DATA_LINK_ADDRESS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TRANSPORT_ADDRESS 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_PROVIDER_INFO 혹은 TDI_QUERY_PROVIDER_INFORMATION: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_PROVIDER_INFO 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_PROVIDER_STATISTICS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_PROVIDER_STATISTICS 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_DATAGRAM_INFO: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_DATAGRAM_INFO 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 보통 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다. 하부의 트랜스포트가 그것을 지원한다면 FileObj는 주소를 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_MAX_DATAGRAM_INFO: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 TDI_MAX_DATAGRAM_INFO 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 보통 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다. 하부의 트랜스포트가 그것을 지원한다면 FileObj는 주소를 구현하는 열린 파일 객체를 가리켜야한다.

하부의 트랜스포트는 드라이버 개발자의 결정에서 정보 쿼리 리퀘스트의 추가적인 타입을 지원할 수 있다. 그러한 트랜스포트는 가장 중요한 비트가 설정된 TDI_QUERY_XXX 코드를 정의해야한다.

게다가 NetBIOS 트랜스포트의 클라이언트는 QType을 위해서 다음을 서술해야한다:

TDI_QUERY_SESSION_STATUS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 SESSION_BUFFER 구조체에 의해서 뒤따르는 SESSION_HEADER로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.
TDI_QUERY_ADAPTER_STATUS: 트랜스포트는 MdlAddr에 맵된 클라이언트 제공 버퍼로 ADAPTER_STATUS 구조체로써 포맷된 정보를 리턴해야한다는 것을 서술한다.
FileObj는 통제 채널을 구현하는 열린 파일 객체를 가리켜야한다.

앞의 구조체들에 대한 더 많은 정보는 플랫폼 SDK를 봐라.

MdlAddr

클라이언트에 의해서 설정된 필요한 리퀘스트 특정 정보를 포함하는 클라이언트 제공 버퍼를 매핑하는 MDL을 가리킨다. 트랜스포트는 이 버퍼안으로 주어진 QType에 따라서 포맷된 리퀘스트된 정보를 리턴한다.

주석

TdiBuildQueryInformation 함수는 주어진 IRP의 트랜스포트 I/O 스택 로케이션안에 MajorFunction로써 IRP_MJ_INTERNAL_DEVICE_CONTROL을 설정하고 MinorFunction로써 TDI_QUERY_INFORMATION을 설정한다.

TDI 클라이언트는 연결상태 정보, 클라이언트가 사용할 수 있는 브로드캐스트 주소, 보내기나 데이타그램이나 사용자 연결 데이타를 위해서 사이즈 제한과 같은 트랜스포트의 특징같은 정보를 위해서 하부의 트랜스포트에게 물어보기 위해서 쿼리 리퀘스트를 사용할 수 있다.

클라이언트는 명시된 QType에 의존하여 주소, 연결 엔드포인트, 통제 채널에 대한 정보를 쿼리할 수 있다. 클라이언트는 주어진 QType에 적절한 열린 파일 객체로 TdiBuildQueryInformation 함수에 대한 FileObj 포인터를 제공해야한다. 그렇지 않으면 하부의 트랜스포트는 쿼리 리퀘스트를 만족시킬 수 없다.

TdiBuildQueryInformation 함수는 TDI_REQUEST_KERNEL_QUERY_INFORMATION 구조체의 RequestConnectionInformation 멤버를 NULL로 설정했기 때문에 NetBIOS 트랜스포트의 클라이언트는 TDI_QUERY_FIND_NAME 타입의 쿼리를 가지고 TdiBuildQueryInformation 함수를 사용할 수 없다. TDI_QUERY_FIND_NAME을 사용하여 TDI_QUERY_INFORMATION 리퀘스트에 대한 IRP를 설정하기 위해서 NetBIOS 트랜스포트의 클라이언트는 TdiBuildQueryInformation 함수를 위해서 그 코드와 유사한 코드를 사용할 수 있지만 RequestConnectionInformation에 대해서 TDI_CONNECTION_INFORMATION 구조체의 포인터를 서술해야한다.