TDI_ASSOCIATE

TDI_ASSOCIATE_ADDRESS

커널 모드 클라이언트가 TDI_ASSOCIATE_ADDRESS 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버에게 열린 특정 로컬 주소와 열린 연결 엔드포인트사이의 연관을 짓기를 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_SUCCESS
STATUS_CONNECTION_ESTABLISHED
STATUS_INVALID_CONNECTION
STATUS_INVALID_HANDLE
STATUS_INVALID_PARAMETER

IoStatus.Information 멤버는 이 리퀘스트가 데이타 전송을 하지 않기 때문에 0 이다.

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_ASSOCIATE_ADDRESS를 서술한다.

IrpSp->FileObject

IrpSp->Parameters에 서술된 주소와 연관이 있는 연결 엔드포인트를 구현하는 열린 파일 객체를 가리킨다. 트랜스포트는 연결에 대해서 유지하는 상태를 접근하기 위해서 FsContext와 가능하다면 FsContext2 필드를 사용한다.

IrpSp->Parameters

다음과 같이 정의되는 TDI_REQUEST_KERNEL_ASSOCIATE 구조체를 가리킨다:


struct _TDI_REQUEST_KERNEL_ASSOCIATE {

    HANDLE  AddressHandle;

} TDI_REQUEST_KERNEL_ASSOCIATE, *PTDI_REQUEST_KERNEL_ASSOCIATE;

트랜스포트는 다음처럼 이 구조체의 멤버를 사용한다:

AddressHandle: 주소를 구현하는 파일 객체에 대한 클라이언트 제공 핸들을 서술한다. 트랜스포트는 연결 엔드포인트와 연관이되는 로컬 주소를 구현하는 파일 객체로의 참조를 야기하는 파일 객체의 포인터로 이 핸들을 바꾸기 위해서 ObReferenceObjectByHandle 함수를 호출할 수 있다. 트랜스포트는 이 주소에 대해서 유지하는 상태를 접근하기 위해서 이 파일 객체의 FsContext와 가능하다면 FsContext2 필드를 사용한다.

주석

커널 모드 클라이언트는 트랜스포트 드라이버로 선택적으로 TDI_ACCEPT 리퀘스트에 의해서 뒤따르는 TDI_LISTEN 리퀘스트를 가지고 혹은 TDI_CONNECT 리퀘스트를 가지고 원격지와 엔드포인트 대 엔드포인트 연결을 하기전에 associate-address 리퀘스트를 해야한다. 클라이언트는 associate-address 리퀘스트를 하기전에 TDI_QUERY_INFORMATION 혹은 TDI_SET_INFORMATION 리퀘스트를 가지고 연결에 대해서 정보를 얻거나 설정할 수 있다.

연결 엔드포인트가 주소와 연관된 후에 클라이언트는 하나의 예외를 가지고 연결상에서 트랜스포트에게 어떤 다른 TDI_XXX 리퀘스트를 할 수 있다: 클라이언트가 트랜스포트로 성공적인 TDI_DISASSOCIATE_ADDRESS 리퀘스트를 할 때까지 특정 엔드포인트를 위해서 클라이언트는 TDI_ASSOCIATE_ADDRESS 리퀘스트를 다시 할 수 없다.

예를들어 클라이언트의 순차적인 TDI_LISTEN 리퀘스트가 원격지에서 연결을 제공하자마자 만족된다면 하나이상의 TDI_SET_EVENT_HANDLER 리퀘스트를 제출하므로써 주소상에서 하나이상의 ClientEvent(Chained)Receive(Expedited) 핸들러를 등록해야한다. 반면에 지연된 연결 승인을 위해서 listen을 설정한 클라이언트는 제공된 연결을 위해서 TDI_ACCEPT 를 제출할 때까지만 receive-event 핸들러 등록을 지연한다.

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