TDI_DISASSOCIATE_ADDRESS

커널 모드 클라이언트가 TDI_DISASSOCIATE_ADDRESS 리퀘스트를 할 때 커널 모드 클라이언트는 TDI 트랜스포트 드라이버로 하여금 특정 로컬 주소와 연결 엔드포인트 사이에서 성립된 관계를 파기하도록 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_SUCCESS
STATUS_INVALID_CONNECTION


IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_DISASSOCIATE_ADDRESS를 서술한다.

IrpSp->FileObject

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

주석

연관된 로컬 주소로부터 연결을 비활성화하기 위해서 그 클라이언트가 원격지와의 연결해체를 시작하든 안하든 연결 엔드포인트와의 관계를 끊는 이러한 리퀘스트를 클라이언트는 행한다.

주소가 관계가 끊긴 후에 클라이언트는 또다른 TDI_ASSOCIATE_ADDRESS 리퀘스트를 하므로써 또다른 열린 로컬 주소를 가지고 연결 엔드포인트를 다시 연관짓거나 다른 연결 엔드포인트를 가지고 주소를 다시 연관 짓는다. 결국 트랜스포트는 그러한 주소와 연결 엔드포인트를 구현하는 파일 객체가 TDI_DISASSOCIATE_ADDRESS 리퀘스트의 완료 후에는 닫힐 것이라는 것을 가정할 수 없다.

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