TDI_LISTEN

커널 모드 클라이언트가 TDI_LISTEN 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트로 하여금 원격지로부터 엔드포인트 대 엔드포인트 연결을 하는 제공을 위해서 listen하도록 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_SUCCESS
STATUS_PENDING
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_CONNECTION

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_LISTEN을 서술한다.

IrpSp->FileObject

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

클라이언트가 트랜스포트로 성공적인 TDI_ASSOCIATE_ADDRESS 리퀘스트를 할 때 이 연결 엔드포인트는 미리 로컬 주소와 연관되어있다.

IrpSp->Parameters

DI_REQUEST_KERNEL 구조체와 연관된 TDI_REQUEST_KERNEL_LISTEN 구조체를 가리킨다.

트랜스포트로 하여금 지연된 연결 승인을 하도록하는 TDI_QUERY_ACCEPT를 가지고 클라이언트는 RequestFlags 멤버를 설정할 수 있다: 클라이언트로 이 listen 리퀘스트를 완료하기 위해서 적절한 연결 제공이 RequestConnectionInformation 함수를 호출하므로써 서술되면 원격지로부터 들어올 때 클라이언트는 TDI_ACCEPT 리퀘스트를 제시하므로써 연결을 받아들이든지 TDI_DISCONNECT 리퀘스트를 가지고 원격지 연결 제공을 거절하든지를 결정할 수 있다.

반면에 RequestFlags가 0 일 때 하부의 트랜스포트는 즉시 들어오는 적절한 연결 제공을 받아들여야한다. TDI_QUERY_ACCEPT가 설정되지만 트랜스포트가 지연된 연결 승인을 지원하지 않는다면 트랜스포트는 이 listen 리퀘스트를 실패한다.

클라이언트는 트랜스포트가 다음과 같이 원격지로부터 연결 제공을 받아들이는지를 결정하기 위해서 사용하는 RequestConnectionInformation에 TDI_CONNECTION_INFORMATION 타입의 버퍼안에 정보를 제공한다:

UserData

연결을 리퀘스트하는 원격지로 전송하는 트랜스포트를 위해서 호출자 제공 데이타의 버퍼를 가리킨다. 트랜스포트가 지연된 연결 승인을 지원하고 클라이언트가 DI_QUERY_ACCEPT를 가지고 RequestFlags를 설정한다면 이 멤버는 NULL이다.

UserDataLength

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

Options

TDI_REQUEST_KERNEL_LISTEN 구조체의 RequestFlags 멤버안에 설정된 값에 대응된다.

OptionsLength

sizeof(ULONG)으로 설정되어야한다; TDI_QUERY_ACCEPT가 RequestFlags에 설정되지 않는다면 무의미하다.

RemoteAddress

연결 제공을 예상하고 로컬의 클라이언트가 listen하는 원격의 주소를 서술하는 버퍼를 가리킨다. 하부의 트랜스포트가 특정 주소를 서술하기 위해서 규정과 신택스를 정의한다면 이 서술은 특정 주소가 될 수 있다. 이 멤버는 클라이언트가 원격지로부터 엔드포인트 대 엔드포인트 연결을 받아들일 것이다라는 것을 인디케이트하므로써 NULL일 수 있다.

RemoteAddressLength

RemoteAddress에 버퍼의 바이트 사이즈를 서술한다. 0은 원격지로부터 연결 제공이 이 클라이언트로 받아들일 수 있다는 것을 인디케이트한다.

TDI_REQUEST_KERNEL 구조체안에 ReturnConnectionInformation에 호출자 제공 버퍼는 TDI_CONNECTION_INFORMATION 구조체로써 포맷된다. 트랜스포트는 listen 리퀘스트의 완료에서 이 버퍼안에 원격지로부터 연결 제공에 대한 정보를 리턴한다.

주석

TDI_QUERY_ACCEPT가 RequestFlags안에 설정됐는지에 의존하여 트랜스포트는 로컬의 클라이언트를 대신하여 제공된 원격의 연결을 받아들임으로써 혹은 그 클라이언트로 그러한 제공의 승인을 지연하거나 거절하므로써 listen 리퀘스트를 완료한다.

listen 리퀘스트를 성공적으로 시작하기 위해서 로컬의 클라이언트는 idle 연결 엔드포인트와 연관된 트랜스포트 주소를 가져야한다. 즉 연결을 구현하는 IrpSp->FileObject에 파일 객체를 위해서 트랜스포트는 TDI_ASSOCIATE_ADDRESS 리퀘스트를 만족시킨다. 연결 엔드포인트를 위해서 각각의 트랜스포트가 FsContext나 FsContext2에 유지하는 컨텍스트의 부분은 트랜스포트가 관계를 맺을 때 설정하는 연관된 주소를 구현하는 파일 객체에 대한 포인터이다.

성공적인 TDI_ASSOCIATE_ADDRESS 리퀘스트를 제시한 후에 클라이언트는 클라이언트가 제공된 연결을 받아들일 때까지 트랜스포트 드라이버가 FIFO 순서로 처리해야하는 TDI_LISTEN 리퀘스트의 수를 제시할 수 있다.

트랜스포트는 드라이버 결정 순서로 모드 클라이언트로부터 들어오는 리퀘스트를 처리할 수 있다.

TDI_LISTEN 리퀘스트를 하기 전에 클라이언트가 연결 엔드포인트와 연관된 주소상에서 ClientEvent(Chained)Receive와 ClientEvent(Chained)ReceiveExpedited 핸들러를 등록했다면 트랜스포트가 클라이언트의 listen 리퀘스트를 완료하기 전에 원격지로부터 연결을 받아들이자 마자 리시브는 그 클라이언트를 위해서 들어올 수 있다. 그러한 클라이언트는 listen 리퀘스트를 하지마자 성립되는 엔드포인트 대 엔드포인트 연결을 위해서 준비되어야한다. 그리고 트랜스포트는 listen 리퀘스트의 완료를 가지고 동시에 그 클라이언트로 리시브를 인디케이트하기 위해서 준비되어야한다

일반적으로 TDI 트랜스포트 드라이버는 대기 리퀘스트가 연관된 로컬 주소를 구현하는 클라이언트의 열린 파일 객체상에서 지연되는 한 등록된 ClientEventConnect 핸들러를 호출할 수 없다. 그러나 드라이버는 트랜스포트가 IrpSp->Parameters.RequestConnectionInformation에 제공된 원격의 주소 승인 criteria가 완료됨으로부터 대기 연산을 방해할 것이다는 것을 결정한다면 그러한 대기가 지연중일 때 ClientEventConnect 함수를 호출할 수 있다.

클라이언트 제공 원격지의 주소화된 정보는 트랜스포트가 지연된 대기 리퀘스트를 위해서 RequestFlags를 체크하기 전에 적용된 필터로써 동작한다. 들어오는 연결 제공이 대기 IRP안에 명시된 주소와 어울리지 않는 원격지의 주소로부터 들어왔을 때 트랜스포트는 클라이언트를 위해서 대기를 완료할 수 없다. 원격지로부터 들어오는 연결 제공이 주어진 주소 승인 criteria를 만족할 때 트랜스포트는 다음중 하나의 방법으로 클라이언트의 대기 리퀘스트를 만족시킬 수 있다:

• TDI_QUERY_ACCEPT가 RequestFlags에 설정되지 않거나 드라이버가 지연된 연결 승인을 지원하지 않는다면 트랜스포트는 원격지로 승인을 보내고 IRP의 상태 블럭을 설정하고 통제를 리턴하는 것과 마찬가지로 적절한 데이타를 가지고 IrpSp->Parameters.ReturnConectionInformation에 버퍼를 설정한다.
• TDI_QUERY_ACCEPT가 RequestFlags에 설정된다면 트랜스포트는 IrpSp->Parameters.ReturnConnectionInformation에 버퍼를 설정하고 제공된 연결에 대한 클라이언트의 승인 혹은 거절을 기다리기 위해서 타임아웃 간격을 설정한다. 그리고 통제를 리턴한다. 로컬의 클라이언트는 타임아웃 간격안에서 제공된 연결을 승인하거나 거절해야한다: 그렇지 않으면 트랜스포트는 원격지로 거러즐 보내야한다.

대기중에 부분적인 주소 서술 지원에 더해서 TDI 트랜스포트는 그들의 클라이언트에 의해서 QOS(quality-of-service) 서술을 지원할 수 있다. 예를들어 트랜스포트는 TDI 드라이버 특정 신택스와 semantic을 가지고 변수화된 길이로 카운트된 문자열을 사용하여 클라이언트로 하여금 QOS를 서술하도록 한다.

TdiBuildListen은 클라이언트가 이 IRP를 채우기 위해서 사용하는 매크로이다.