TdiBuildDisconnect

VOID
   TdiBuildDisconnect (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN PLARGE_INTEGER Time,
      IN PULONG Flags,
       IN PTDI_CONNECTION_INFORMATION RequestConnectionInfo,
       OUT PTDI_CONNECTION_INFORMATION ReturnConnectionInfo
      );

TdiBuildDisconnect 함수는 로컬의 클라이언트가 원격지와 이미 엔드포인트 대 엔드포인트 연결을 성립했거나 그 클라이언트가 전에 그러한 연결 성립을 기대해서 대기 리퀘스트를 했던 하부 트랜스포트로의 TDI_DISCONNECT 리퀘스트를 위해서 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

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

DevObj

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

FileObj

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

• 원격지와 엔드포인트 대 엔드포인트 연결을 성립하기 위해서 TdiBuildConnect 함수를 가지고 설정된 리퀘스트를 성공했다.
• TDI_CONNECT 리퀘스트를 시작한 원격지로부터 이 연결 제공을 받아들였다.
• TdiBuildListen 함수를 가지고 설정된 원격지로부터 연결 제공을 만족하는 리퀘스트를 성공적으로 제출했다.

CompRoutine

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

Contxt

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

Time

트랜스포트가 연결 해제 시도를 위해서 사용하는 시스템 관련 타임아웃을 서술하는 변수를 가리킨다. 아니면 이 매개변수는 NULL일 수 있다.

명확한 타임아웃은 트랜스포트가 이 연결해제 리퀘스트를 실패하기 전에 연결 해제 시도가 지연상태를 유지하도록 허락하는 현재 시스템 시간과 관계된 음의 100 나노초 간격의 수로써 서술되어야한다. 이 포인터가 NULL이면 트랜스포트는 원격지로부터의 연결해제를 위해서 자신의 기본 타임아웃 간격을 사용한다.

Flags

0이나 하부의 트랜스포트가 통제된 연결해제를 지원한다면 다음중 하나의 값이 될 수 있는 변수를 가리킨다:

TDI_DISCONNECT_ABORT

지연된 리퀘스트를 완료하려는 시도없이 하부의 트랜스포트는 즉시 연결을 닫아야 한다는 것을 서술한다. 이 값은 Flags에 0으로 설정되는 것과 마찬가지로 기본이다.

클라이언트는 연결에서 작업이 되는 시간에 TDI_DISCONNECT_ABORT를 가지고 연결해제 리퀘스트를 할 수 있다. 예를들어 그러한 클라이언트는 전에 했던 대기 리퀘스트나 지연된 연결을 취소하고자한다. 또다른 예로써 클라이언트는 하부의 트랜스포트로 하여금 TDI_DISCONNECT_RELEASE를 가지고 앞선 연결해제 리퀘스트가 지연된 상태에 있을 때 TDI_DISCONNECT_ABORT를 가지고 두번째 연결해제 리퀘스트를 제시하므로써 엔드포인트 대 엔드포인트 연결을 닫도록 강요할 수 있다.

TDI_DISCONNECT_RELEASE

나중에 서술(주석을 봐라)된 것처럼 하부의 트랜스포트는 통제된 연결 해제를 시작해야한다는 것을 서술한다. 또한 원격지의 클라이언트는 통제된 연결해제를 확실히 하기위해서 이 값을 가지고 연결해제 리퀘스트를 제시한다.

TDI_DISCONNECT_WAIT 플래그는 사용되지 않는다.

클라이언트는 연결해제 리퀘스트에서 선행되는 옵션중에 하나만을 설정할 수 있다. 트랜스포트는 이 옵션을 여러개하는 것을 실패할 것이다.

RequestConnectionInfo

엔드포인트 대 엔드포인트의 통제된 연결해제를 시작할 때 클라이언트가 어떤 보내기를 한다면 연결해제 데이타를 포함하는 TDI_CONNECTION_INFORMATION 구조체를 포함하는 클라이언트 제공 버퍼를 가리킨다. 이 매개변수는 호출자가 TDI_DISCONNECT_RELEASE를 가지고 연결해제를 시작한다면 NULL이어야한다.

ReturnConnectionInfo

원격의 클라이언트가 통제된 연결해제를 시작한다고 추측되는 원격지로부터 받은 연결해제 데이타를 리턴하는 트랜스포트안에 TDI_CONNECTION_INFORMATION 구조체로써 포맷된 호출자 제공 버퍼를 가리킨다. 이 매개변수는 호출자가 TDI_DISCONNECT_RELEASE를 가지고 연결해제를 동의하지 않는다면 NULL이어야한다. 로컬의 클라이언트는 TdiBuildListen 혹은 TdiBuildConnect 함수를 가지고 설정된 리퀘스트에서 연결을 재사용한 후에 리턴된 연결해제 데이타를 되찾을 수 없다.

주석

TdiBuildDisconnect 함수는 주어진 IRP의 트랜스포트 I/O 스택 로케이션안에 MajorFunction로써 IRP_MJ_INTERNAL_DEVICE_CONTROL을 설정하고 MinorFunction로써 TDI_DISCONNECT를 설정한다. 이 IRP는 이미 성립된 원격지와의 엔드포인트 대 엔드포인트 연결이 파괴됐음을 리퀘스트한다.

또한 클라이언트는 원격지에 의해서 시작된 연결로 들어오는 리퀘스트를 거절하는 연결해제 리퀘스트를 제시할 수 있다. 이런 경우에 클라이언트는 선택된 TDI_QUERY_ACCEPT 옵션을 가지고 전에 행해진 완료된 TDI_LISTEN 리퀘스트에 응답중이다. 혹은 클라이언트는 ClientEventConnect 함수로부터 제공된 연결해제를 거절중이다. 그러한 클라이언트는 Flags에 0이나 TDI_DISCONNECT_ABORT를 가지고 TdiBuildDisconnect 함수를 호출한다.

성립된 엔드포인트 대 엔드포인트 연결이 해제중일 때 하부의 트랜스포트 드라이버는 보통 연결을 위해서 들어오는 리퀘스트를 거절하고 명시된 연결 엔드포인트에서의 모든 동작을 멈춘다. 그러나 그 연결 엔드포인트는 연결해제 연산이 행해졌을 때 클라이언트에 의한 재사용을 위해서 유효한 채로 남겨진다.

어떤 연결해제 연산이 완료될 시간이기 때문에 연결해제 IRP를 완성하기 전에 성립된 엔드포인트 대 엔드포인트 연결상에서 클라이언트는 추가적인 TSDU를 받을 수 있다. 그러므로 클라이언트는 연결해제 완료통보를 받을 때까지 유지되는 컨텍스트가 그러한 연결을 위해서 유효하다고 가정할 수 있다. 예를들어 TdiBuildDisconnect 함수로 제공되는 IoCompletion 루틴으로의 호출에 의해서 그러하다. 연결해제 완료통보는 연결상에서 리시브 인디케이션을 포함하는 모든 동작의 중단을 의미한다.

클라이언트가 TDI_DISCONNECT_RELEASE를 가지고 통제된 연결해제를 리퀘스트하지 않는다면 트랜스포트는 연결에서 두드러진 I/O 리퀘스트를 완료하지 않았고 연결해제 리퀘스트로부터 통제를 리턴하기 전에 원격지가 연결해제를 통보했음을 확인하지 않았다. 그러한 연결해제 리퀘스트를 위해서 하부의 트랜스포트는 단지 주어진 연결에서 모든 두드러진 리퀘스트를 취소한다. 그리고 클라이언트의 연결해제 리퀘스트를 완료하고 통제를 리턴한다.

하부의 트랜스포트가 이것을 지원한다면 성립된 엔드포인트 대 엔드포인트 연결상의 클라이언트는 통제된 연결해제 리퀘스트를 할 수 있다. 그렇다면 TDI_DISCONNECT 리퀘스트를 가지고 연결해제 연산을 시작한 클라이언트는 트랜스포트로 하여금 그들의 연산을 동등하게 해서 원격지가 연결이 닫힌다는 것을 알게한다. 그리고 트랜스포트는 연결이 파괴되기 전에 연결상에서 지연된 전송을 완료하도록한다. 이런 상황에서 원격지의 클라이언트는 하부의 트랜스포트가 시작하는(로컬의) 클라이언트 연결해제 리퀘스트로부터 리턴되기 전에 연결해제를 확인해야한다.

다음은 통제된 연결해제를 위한 순차적인 연산을 요약한다:

1. 로컬의 클라이언트는 Flags에 TDI_DISCONNECT_RELEASE가 설정된 연결해제 리퀘스트를 하므로써 연결해제를 시작한다. 결국 이 클라이언트는 연결에서 더이상 데이타를 보낼 수 없다. 하지만 원격지로부터 계속 데이타를 받을 수 있다. 하부의 트랜스포트는 지연된 보내기 연산을 수행하고그러한 로컬의 클라이언트가 연결해제 리퀘스트를 할 때 현재 유지하고 있는 지연된 보내기 리퀘스트를 완료한다.
2. 원격지상에서 트랜스포트는 클라이언트가 한 지연된 리시브 리퀘스트를 완료한다. 그리고나서 원격지의 트랜스포트는 클라이언트에게 지연된 연결해제를 알린다. 원격지의 클라이언트가 이벤트 핸들러를 등록했다면 ClientEventDisconnect 함수를 호출하므로써 알리고 그렇지 않다면 클라이언트에 의해서 만들어진 두드러진 리퀘스트에서 에러 코드를 리턴하므로써 알린다. 그러한 통보 후에 원격지의 클라이언트는 연결상에서 더이상 데이타를 받을 수 없다. 하지만 하부의 트랜스포트로 TDI_DISCONNECT_RELEASE 옵션을 가지고 연결해제 리퀘스트를 제시할 때까지 데이타 전송을 계속할 수 있다.
3. 원격지의 클라이언트가 데이타 전송을 마쳤을 때 원격의 클라이언트는 선택된 TDI_DISCONNECT_RELEASE를 가지고 하부의 트랜스포트로 연결해제 리퀘스트를 한다. 하부의 트랜스포트는 클라이언트의 연결해제 리퀘스트를 완료하기 전에 보통 연결상에서 모든 두드러진 보내기를 완료한다. 이 트랜스포트가 연결해제로부터 리턴될 때 연결은 원격의 클라이언트 관점에서 닫혔다. 그러나 연결 엔드포인트는 아직도 유효하고 클라이언트는 나중에 그것을 재사용할 수 있다.
4. 원격의 트랜스포트는 원격지에서 연결해제 완료를 확인하기 위해서 로컬의 트랜스포트에게 알린다. 이 시점에서 원래 통제된 연결해제 리퀘스트는 로컬의 트랜스포트에 의해서 완료되고 연결은 로컬의 클라이언트 관점에서 닫혔다. 그러나 연결 엔드포인트는 아직도 유효하고 클라이언트는 나중에 그것을 다시 사용할 수 있다.