TDI_QUERY_INFORMATION

커널 모드 클라이언트는 TDI_QUERY_INFORMATION 리퀘스트를 할 때 특정 연결에서의 I/O에 대한 브로드캐스트 주소, 트랜스포트의 능력, 혹은 현재 통계와 같은 클라이언트 특정 타입의 정보를 리턴하도록 하부의 TDI 트랜스포트 드라이버에게 요구한다.

IRP

IrpSp로써 다음의 리스트에 보여지는 IRP안에 자신의 I/O 스택 로케이션에 대한 포인터를 얻기 위해서 주어진 Irp를 가지고 트랜스포트는 IoGetCurrentIrpStackLocation 함수를 호출한다. IRP에 대한 포인터는 Irp로써 다음의 리스트에 보여진다. 이 리퀘스트와 연관된 IRP 멤버는다음과 같다:

Irp->IoStatus.Status

쿼리 정보 리퀘스트의 마지막 상태를 서술한다. 트랜스포트는 IRP를 완료하기 전에 가능하다면 다음중 하나의 값으로 이 멤버를 설정한다:

STATUS_SUCCESS
STATUS_BUFFER_OVERFLOW
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_CONNECTION
STATUS_INVALID_DEVICE_REQUEST
STATUS_NOT_IMPLEMENTED

Irp->IoStatus.Information

트랜스포트가 클라이언트로 리턴하는 정보의 바이트 수를 서술한다.

IrpSp->MajorFunction

IRP_MJ_INTERNAL_DEVICE_CONTROL를 서술한다. 트랜스포트가 TDI_XXX 리퀘스트만을 다루는 TdiDispatchInternalDeviceControl 함수를 익스포트한다면 이 멤버를 무시할 수 있다.

IrpSp->MinorFunction

TDI_QUERY_INFORMATION을 서술한다.

IrpSp->FileObject

주소, 연결 엔드포인트, 혹은 통제 채널을 구현하는 열린 파일 객체를 가리킨다. 트랜스포트는 이 주소, 연결 엔드포인트, 혹은 통제 채널에 대해서 유지하는 상태를 접근하기 위해서 FsContext와 가능하다면 FsContext2 필드를 사용한다.

IrpSp->Parameters

다음과 같이 정의된 TDI_REQUEST_KERNEL_QUERY_INFORMATION 구도체를 가리킨다:


struct _TDI_REQUEST_KERNEL_QUERY_INFO {

    LONG QueryType;

    PTDI_CONNECTION_INFORMATION RequestConnectionInformation;

} TDI_REQUEST_KERNEL_QUERY_INFORMATION, *PTDI_REQUEST_KERNEL_QUERY_INFORMATION;

트랜스포트는 RequestConnectionInformation 멤버가 전형적으로 NULL이기 때문에 이 멤버를 무시할 수 있따. NetBIOS 트랜스포트는 나중에 서술(주석을 봐라)되듯이 이 멤버를 요구한다. 트랜스포트는 클라이언트가 리퀘스트한 정보가 무엇인지를 결정하기 위해서 QueryType 멤버를 체크한다. 그리고 리턴되는 정보의 포맷을 결정한다. 때때로 Irp->MdlAddress에 맵된 버퍼의 클라이언트 제공 내용을 검사하기도 한다.

모든 TDI 트랜스포트에 대해서 QueryType은 다음 시스템 정의 값중에 하나로 설정될 수 있다:

TDI_QUERY_ADDRESS_INFO: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_ADDRESS_INFO 구조체로써 포맷된 특정 로컬 주소에 대해서 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.; IrpSp->FileObject는 정보를 리턴하기 위해서 주소와 이미 연관된 연결 엔드포인트나 주소를 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_CONNECTION_INFO: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_CONNECTION_INFO 구조체로써 포맷된 특정 연결에 대한 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 정보를 리턴하기 위해서 연결을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_BROADCAST_ADDRESS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TRANSPORT_ADDRESS 구조체로써 포맷된 브로드캐스트 주소를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_NETWORK_ADDRESS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TRANSPORT_ADDRESS 구조체로써 포맷된 로컬 주소를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_DATA_LINK_ADDRESS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TRANSPORT_ADDRESS 구조체로써 포맷된 데이타링크 주소를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_PROVIDER_INFO 혹은 TDI_QUERY_PROVIDER_INFORMATION: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_PROVIDER_INFO 구조체로써 포맷된 자신의 능력에 대한 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_PROVIDER_STATISTICS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_PROVIDER_STATISTICS 구조체로써 포맷된 자원사용에 대한 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다.
TDI_QUERY_DATAGRAM_INFO: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_DATAGRAM_INFO 구조체로써 포맷된 사이즈의 제한과 데이타그램의 수에 대한 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다. 또한 트랜스포트는 트래스포트 개발자의 결정에서 열린 트랜스포트 주소 상에서 이 쿼리를 지원할 수 있다.
TDI_QUERY_MAX_DATAGRAM_INFO: MdlAddress에 맵된 클라이언트 제공 버퍼안에 TDI_MAX_DATAGRAM_INFO 구조체로써 포맷된 데이타그램 사이즈의 제한에 대한 정보를 리턴하기 위해서 트래스포트를 리퀘스트한다.
IrpSp->FileObject는 통제 채널을 구현하는 파일 객체를 가리켜야한다. 또한 트랜스포트는 트래스포트 개발자의 결정에서 열린 트랜스포트 주소 상에서 이 쿼리를 지원할 수 있다.

모든 트랜스포트가 지원해야하는 앞의 쿼리에 추가해서 특정 트랜스포트는 다른 것들을 지원한다. 예를들어 NetBIOS 트랜스포트는 나중에 서술(주석을 봐라)되듯이 세 개의 추가적인 시스템 정의 TDI_QUERY_XXX에 대해서 응답해야한다.

Irp->MdlAddress

클라이언트 제공 내용이 리퀘스트를 수행하기 위해서 요구하는 무엇인가를 포함하는 클라이언트 제공 버퍼를 매핑하는 MDL의 체인에서 가능하다면 처음 MDL을 가리킨다. 입력 내용과 이 버퍼의 포맷은 주어진 QueryType에 의존한다.

주석

NetBIOS 트랜스포트에 대해서 QueryType은 다음중 하나를 서술할 수 있다:

TDI_QUERY_FIND_NAME: MdlAddress에 맵된 클라이언트 제공 버퍼안에 FIND_NAME_BUFFER 구조체를 따르는 FIND_NAME_HEADER 구조체로써 포맷된 정보를 리턴하기 위해서 NetBIOS 트랜스포트를 리퀘스트한다. 이 쿼리 타입에 대해서 RequestConnectionInformation은 유효한 TDI_CONNECTION_INFORMATION 구조체를 가리켜야한다.
TDI_QUERY_SESSION_STATUS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 SESSION_BUFFER 구조체를 따르는 SESSION_HEADER 구조체로써 포맷된 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
TDI_QUERY_ADAPTER_STATUS: MdlAddress에 맵된 클라이언트 제공 버퍼안에 ADAPTER_STATUS 구조체로써 포맷된 정보를 리턴하기 위해서 트랜스포트를 리퀘스트한다.
앞의 NetBIOS 특정 구조체에 대한 더 많은 정보를 위해서는 플랫폼 SDK를 봐라.

대부분의 경우에 TdiBuildQueryInformation 함수는 클라이언트가 이 IRP안에 채우기 위해서 사용하는 매크로이다.

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 구조체의 포인터를 서술해야한다.