TdiBuildDisassociateAddress

VOID
   TdiBuildDisassociateAddress (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt
      );

TdiBuildDisassociateAddress 함수는 로컬 클라이언트가 주소와 연결 엔드포인트를 이미 연관시킨 하부의 트랜스포트로 TDI_DISASSOCIATE_ADDRESS 리퀘스트를 위해서 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

더 상위 레벨 네트웍 컴포넌트에서 발생하거나 TdiBuildInternalDeviceControlIrp 함수를 가지고 할당된 클라이언트 제공 IRP를 가리킨다.

DevObj

하부의 TDI 트랜스포트 드라이버에 의해서 생성된 장치 객체를 가리킨다.

FileObj

연결 엔드포인트를 구현하는 파일 객체를 가리킨다. 클라이언트는 이 연결과 로컬 주소사이에서 연관을 설정하기 위해서 트랜스포트로 TdiBuildAssociateAddress 함수를 가지고 설정된 리퀘스트를 전에 성공했다.

CompRoutine

클라이언트 제공 IoCompletion 루틴의 엔트리 포인트를 서술하거나 NULL이다. 클라이언트가 이 매개변수를 NULL로 설정하지 않느다면 주어진 IRP를 완료할 때 I/O 매니저는 이 루틴을 호출한다.

Contxt

클라이언트 결정 컨텍스트를 가리킨다. 이 클라이언트 제공 포인터는 완료된 IRP를 가지고 호출될 때 IoCompletion 루틴으로 전달된다. CompRoutine이 NULL이면 Contxt는 NULL이다.

주석

TdiBuildDisassociateAddress 함수는 주어진 IRP의 트랜스포트 I/O 스택 로케이션안에 MajorFunction로써 IRP_MJ_INTERNAL_DEVICE_CONTROL을 설정하고 MinorFunction로써 TDI_DISASSOCIATE_ADDRESS를 설정한다.

커널 모드 클라이언트는 클라이언트가 원격지 혹은 나쁜 versa로부터 연결해체를 시작했든 아니든 연관된 주소 객체에서 비활성의 연결을 위해서 연결 엔드포인트를 연결해제하기 위해서 이 리퀘스트를 한다.

이 리퀘스트가 성공한다면 클라이언트는 TdiBuildAssociateAddress 함수를 가지고 하부의 트랜스포트를 위해서 또다른 IRP를 설정하므로써 또다른 연결 엔드포인트와 로컬 주소 혹은 또다른 로컬 주소와 연결 엔드포인트를 다시 연관시킨다.