TDI_CONNECT

커널 모드 클라이언트가 TDI_CONNECT 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버에게 원격지로의 특정 로컬 연결 엔드포인트에서의 연결을 제공하도록 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_SUCCESS
STATUS_PENDING
STATUS_BAD_NETWORK_PATH
STATUS_INVALID_CONNECTION
STATUS_REMOTE_NOT_LISTENING
STATUS_INSUFFICIENT_RESOURCES
STATUS_REQUEST_TIMED_OUT


IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_CONNECT를 서술한다.

IrpSp->FileObject

로컬 주소와 미리 연관된 연결 엔드포인트를 구현하는 열린 파일 객체를 가리킨다. 이 연결에 대해서 유지되는 상태로의 접근을 위해서 트랜스포트는 FsContext와 가능하다면 FsContext2 필드를 사용한다.

IrpSp->Parameters

TDI_REQUEST_KERNEL 구조체와 대등한 TDI_REQUEST_KERNEL_CONNECT 구조체를 가리킨다.

RequestFlags 멤버는 연결 리퀘스트와는 관계가 없다. 트랜스포트는 RequestConnectionInformation에 버퍼안에 연결이 제공되어야하는 원격지의 주소처럼 클라이언트 제공 정보를 사용한다. 트랜스포트는 RequestConnectionInformation에 클라이언트 제공 버퍼로 정보를 리턴한다. 이 각각의 버퍼는 TDI_CONNECTION_INFORMATION 구조체로 포맷된다.

IrpSp->Parameters.RequestSpecific

연결 제공을 위해서 타임아웃 값을 서술하는 LARGE_INTEGER 변수를 가리키거나 NULL이다. 명확한 타임아웃은 타임아웃 간격을 위해서 현재 시스템 시간과 연관된 음의 100 나노초 유닛으로 서술된다. 이 멤버가 NULL이면 트랜스포트는 1초 보다 작은 값으로 적절한 타임아웃 간격을 선택해야한다.

주석

원격지와 엔드포인트 대 엔드포인트 연결을 성립하기 위한 로컬의 클라이언트에 대해서 TDI_CONNECT 리퀘스트를 하기전에 열린 트랜스포트 주소를 가지고 idle한 로컬 연결 엔드포인트를 연관지어야한다. 서술된 로컬 엔드포인트가 활성화되거나 존재하지 않는다면 트랜스포트는 연결 리퀘스트를 실패한다.

성공한 TDI_CONNECT 리퀘스트에 대해서 원격지의 클라이언트는 열린 TDI_LISTEN 리퀘스트를 가지거나 원격지 상에서 하부의 트랜스포트에 의해서 인디케이트된 연결 제공을 받기 위해서 ClientEventConnect 핸들러를 등록해야한다.

TdiBuildConnect는 클라이언트가 IRP안에 채우기 위해서 사용하는 매크로이다.