TDI_CONNECTION_INFORMATION

typedef struct _TDI_CONNECTION_INFORMATION {

    LONG   UserDataLength;

    PVOID  UserData;

    LONG   OptionsLength;

    PVOID  Options;

    LONG   RemoteAddressLength;

    PVOID  RemoteAddress;

} TDI_CONNECTION_INFORMATION, *PTDI_CONNECTION_INFORMATION;

TDI_CONNECTION_INFORMATION은 커널 모드 클라이언트가 특히 엔드포인트 대 엔드포인트 연결과 연관된 TDI_XXX 내부 장치 통제 리퀘스트의 서브셋을 위해서 하부의 트랜스포트로 전달하거나 받은 구조체의 정보를 정의한다.

멤버

UserDataLength
UserData에 버퍼의 바이트 사이즈를 서술한다. UserData가 NULL이면 0을 서술한다.

UserData
엔드포인트 대 엔드포인트 연결이 성립되거나 해체되었을 때 보내거나 받은 사용자 데이타에 대한 클라이언트 제공 버퍼를 가리킨다.

OptionsLength
Options에 버퍼의 바이트 사이즈를 서술한다.

Options
클라이언트 제공 데이타를 포함하거나 주어진 IOCTL 리퀘스트를 위한 트랜스포트 리턴 데이타를 기다리는 클라이언트 제공 버퍼를 가리킨다.

RemoteAddressLength
RemoteAddress에 버퍼의 바이트 사이즈를 서술한다.

RemoteAddress
클라이언트에 의해서 명시되거나 클라이언트로 트랜스포트에 의해서 리턴된 원격지의 트랜스포트 주소를 포함하는 버퍼를 가리킨다. 이 주소의 신택스는 네트웍과 하부 트랜스포트의 타입에 의존한다.(TA_ADDRESS를 봐라.)

주석

몇몇의 TdiBuildXxx 매크로와 대응하는 TDI_XXX IOCTL 리퀘스트가 TDI 트랜스포트와 그들의 클라이언트 사이에서 정보를 전달하기 위해서 이 구조체를 사용하는 동안에 각각은 TDI_CONNECTION_INFORMATION 구조체의 모든 멤버를 사용하지 않는다.

일반적인 규칙으로 트랜스포트가 주어진 IOCTL 리퀘스트에 대해서 STATUS_PENDING을 리턴한다면 트랜스포트는 이 구조체에 어떤 정보도 리턴하지 않는다. 대신에 드라이버는 IRP를 완료할 때까지만 이 구조체에 데이타 설정을 지연한다.

UserData 제공하기와 받기

엔드포인트 대 엔드포인트 연결이 셩립된 후에 로컬의 클라이언트는 하부의 트랜스포트로 TDI_SEND 리퀘스트를 제출하므로써 원격지로 TSDU를 보낼 수 있다. 로컬 클라이언트는 TDI_RECEIVE 리퀘스트를 제출하므로써, 혹은 등록된 ClientEvent(Chained)Receive(Expedited) 핸들러를 호출하므로써 원격지로부터 TSDU를 받을 수 있다.

그러나 그러한 연결이 성립될 때까지 엔드포인트 대 엔드포인트 연결을 성립중인 두 TDI 클라이언트는 각각의 하부 트랜스포트로 TDI_CONNECT, TDI_LISTEN, 그리고 가능하다면 TDI_ACCEPT 리퀘스트를 가지고 UserData에 버퍼에 데이타를 제공하므로써 데이타를 보낼 수 있다. 유사한 방법으로 그러한 두 클라이언트는 또한 각각의 트랜스포트가 통제된 연결해체를 지원하다는 가정하에 통제된 연결해체 연산이 진행중인 다른 클라이언트로 연결해체 데이타를 제공할 수 있다.

클라이언트는 QType TDI_QUERY_PROVIDER_INFO에 대해서 TdiBuildQueryInformation 함수를 가지고 설정된 쿼리 정보 리퀘스트를 제출하므로써 사용자 데이타의 양에 대해서 트랜스포트 특정 제한을 결정할 수 있다.

클라이언트가 특정 TDI IOCTL 리퀘스트를 가지고 사용자 데이타를 보낼 때 0으로 설정된UserDataLength는 클라이언트가 트랜스포트로 그 리퀘스트안에 사용자 데이타를 제공하지 않았음을 암시한다. 클라이언트가 특정 TDI IOCTL 리퀘스트를 가지고 사용자 데이타를 받을 때 0으로 설정된 UserDataLength는 트랜스포트가 UserData에 버퍼안에 데이타를 리턴하지 않는다는 것을 암시한다. 반면에 트랜스포트는 클라이언트를 위해서 리시브된 데이타의 바이트 수를 UserDataLength로 설정한다.

클라이언트가 0이 아닌 UserDataLength를 서술하고 트랜스포트가 원격지로부터 클라이언트 제공 버퍼에 적절한 것보다 더 많은 데이타를 받는다면 트랜스포트는 클라이언트의 버퍼안에 채울 수 있는 많은 데이타를 리턴한다. 이 경우에 트랜스포트는 연산을 완료하지만 클라이언트로 데이타 절단을 알리는 상태를 리턴한다.

다음의 TDI_XXX IOCTL 리퀘스트를 위해서 UserDataLength는 0이어야하고 UserData는 NULL이어야한다:

TDI_RECEIVE_DATAGRAM과 TDI_SEND_DATAGRAM
TDI_CONNECTION_INFORMATION 구조체는 이 리퀘스트에 대해서 원격지의 주소를 서술하기 위해서만 사용된다.

클라이언트가 지연된 연결 승인을 리퀘스트한다면 TDI_LISTEN
그러한 클라이언트는 원격지로부터 제공된 연결을 받아들일 때 순차적인 TDI_ACCEPT 리퀘스트를 가지고 필요한 사용자 데이타를 제공할 수 있다.

트랜스포트가 특정 TDI IOCTL 리퀘스트를 위해서 클라이언트로 하여금 사용자 데이타를 제공하도록 하지 않을 때 트랜스포트는 클라이언트가 0이 아닌 UserDataLength를 명시한 모든 그러한 리퀘스트를 실패한다.

Options와 OptionsLength 사용하기

TDI_LISTEN 리퀘스트에 대해서 OptionsLength는 0일 수 있고 클라이언트가 TdiBuildListen 함수에 Flags 매개변수에 TDI_QUERY_ACCEPT를 설정한다면 sizeof(ULONG)이다. 그리고 Options는 NULL일 수 있다. 아니면 버퍼는 TDI_QUERY_ACCEPT를 포함한다.

TDI_LISTEN 리퀘스트를 제외하고 트랜스포트는 클라이언트를 위해서 지원하는 추가적인 옵션의 신택스를 정의한다:

  • 클라이언트가 Options에 트랜스포트 특정 정보를 제공했을 때 OptionsLength를 0으로 설정하는 것은 하부의 드라이버가 옵션을 위해서 기본 값을 사용할 수 있다는 것을 암시한다. 트랜스포트가 Options에 정보를 리턴할 때 OptionsLength를 0으로 설정하는 것은 클라이언트가 리턴된 데이타를 사용하지 않고 트랜스포트는 Options를 무시해야한다는 것을 암시한다.

  • 그라힌 클라이언트가 OptionsLength를 0이 아닌 값으로 설정하지만 트랜스포트가 클라이언트 제공 버퍼를 위해서 너무 많은 옵션 문자열을 받는다면 트랜스포트는 옵션 문자열의 끝을 자르고 데이타 절단이 발생했음을 알리는 상태를 가지고 클라이어트의 리퀘스트를 완료한다.

  • 그러한 트랜스포트의 클라이언트가 전송하는 드라이버에 대해서 옵션 값을 서술하는 Options를 사용할 때 드라이버가 실제로 쓴 값은 클라이언트 특정 값과는 다를 수 있다.

RemoteAddress와 RemoteAddressLength 사용하기

이 멤버의 사용은 트랜스포트 특정 주소의 사이즈와 TDI_XXX IOCTL에 의존한다. 일반적으로 로컬의 클라이언트가 연결 제공과 보내기 같은 네트웍 전송 연산을 시작할 때 타겟 원격지 주소를 서술하기 위해서 RemoteAddress를 사용한다. 그러한 연산이 대기와 리시브 리퀘스트를 만족시키는 원격지에서 시작됐을 때 트랜스포트는 RemoteAddress로 정보를 리턴한다.

클라이언트가 RemoteAddressLength를 0으로 서술한다면 트랜스포트는 RemoteAddress를 NULL로 가정한다. 만약 클라이언트가 RemoteAddressLength를 0이 아닌 값으로 서술하지만 트랜스포트가 클라이언트 제공 버퍼에 대해서 너무 긴 주소를 받는다면 드라이버 함수는 클라이언트의 버퍼에 적용시키기 위해서 주소를 자른다. 이 경우에 트랜스포트는 연산을 완료하지만 클라이언트로 데이타 절단을 인디케이트하는 상태 코드를 리턴한다.