TDI_CONNECTION_INFO

typedef struct _TDI_CONNECTION_INFO {

    ULONG          State;

    ULONG          Event;

    ULONG          TransmittedTsdus;

    ULONG          ReceivedTsdus;

    ULONG          TransmissionErrors;

    ULONG          ReceiveErrors;

    LARGE_INTEGER  Throughput;

    LARGE_INTEGER  Delay;

    ULONG          SendBufferSize;

    ULONG          ReceiveBufferSize;

    BOOLEAN        Unreliable;

} TDI_CONNECTION_INFO, *PTDI_CONNECTION_INFO;

TDI_CONNECTION_INFO는 IrpSp->Parameters.QueryType이 TDI_QUERY_CONNECTION_INFO로 설정된 TDI_QUERY_INFORMATION 리퀘스트에 대해서 리턴된 구조체의 정보를 정의한다.

멤버

State
네트웍 상에서 연결의 현재 상태를 서술한다.

Event
TDI 드라이버가 가장 최근에 클라이언트로 인디케이트한 이벤트의 타입을 서술한다. 값은 TDI_EVENT_XXX 코드로 표현된다.

TransmittedTsdus
연결 엔드포인트상에서 전송된 TSDU 수를 서술한다.

ReceivedTsdus
연결 엔드포인트상에서 리시브된 TSDU 수를 서술한다.

TransmissionErrors
연결 엔드포인트상에서 전송중에 에러를 가진 TSDU 수를 서술한다.

ReceiveErrors
연결 엔드포인트상에서 수신중에 에러를 가진 TSDU 수를 서술한다.

Throughput
송수신을 위해서 초당 바이트로 표현되는 연결에서 어림잡은 처리량을 서술한다. Zero은 드라이버가 처리량을 계산할 수 없다는 것을 인디케이트한다.

Delay
음수로 표현되는 연결에서 어림잡은 지연을 서술한다. 패킷 사이즈와는 관계없이 원래 상수인 Delay는 원격지로 보내진 각각의 TSDU의 전송시간에 영향을 미친다.

SendBufferSize
트랜스포트 버퍼가 내부적으로 보낸다면 보내기 버퍼의 바이트 사이즈를 서술한다. 그렇지 않으면 이 멤버는 0이다.

ReceiveBufferSize
트랜스포트 버퍼가 내부적으로 받는다면 받기 버퍼의 바이트 사이즈를 서술한다. 그렇지 않으면 이 멤버는 0이다.

Unreliable
트랜스포트가 연결이 신뢰할 수 없다고 결정한다면 TRUE를 서술한다. 이 멤버가 TRUE라면 트랜스포트는 클라이언트로 연결해체 이벤트를 보낸다. 그리고 이 연결에서 보내고 받기는 실패한다.

주석

ZwCreateFile 함수를 가지고 연결을 구현하는 파일 객체를 연 커널 모드 클라이언트는 로컬 연결의 현재 상태를 결정하기 위해서 쿼리할 수 있다. 그러한 클라이언트는 TdiBuildQueryInformation 함수를 가지고 IRP를 설정하고 QType TDI_QUERY_CONNECTION_INFO로 전달해서 이 정보를 얻고자하는 하부의 트랜스포트로 IRP를 제출한다.

TDI_CONNECTION_INFO는 그러한 쿼리를 위해서 리퀘스트된 정보를 리턴하는 트랜스포트의 포맷을 정의한다.

클라이언트가 원격지와 엔드포인트 대 엔드포인트 연결을 성립했을 때 이 정보의 서브셋만이 내부적 버퍼화를 지원하는 하부 트랜스포트의 SendBufferSize와 ReceiveBufferSize처럼 클라이언트에게 잠재적으로 유용하다. 엔드포인트 대 엔드포인트 연결이 아직 성립되지 않았다면 TDI 트랜스포트는 쿼리 정보 리퀘스트를 실패하거나 아직 관련되지 않은 멤버를 위해서 디폴트 혹은 초기화 값으로 리턴할 수 있다.

결국 커널 모드 클라이언트는 원격지와 엔드포인트 대 엔드포인트 연결이 성립됐을 때 그들의 트랜스포트로 이 리퀘스트를 제출한다. 예를들어 하부의 트랜스포트가 0을 리턴하지 않는다는 가정하에 클라이언트는 이 퀘리에 대해서 리턴된 Delay와 Throughput을 사용하여 네트웍으로 보내기위한 전송시간을 어림잡을 수 있다. TSDU의 바이트 사이즈를 전송하기 위해서 어림잡은 시간은 SendTime = Delay + (n * Throughput)과 같이 계산될 수 있다.