TDI_DISCONNECT

커널 모드 클라이언트가 TDI_DISCONNECT 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버로 하여금 성립된 엔드포인트 대 엔드포인트 연결을 위해서 원격지로부터 연결해체 인디케이션을 알리기 위해서 혹은 원격지에 의해서 제공된 연결을 거절하기 위해서 원격지와의 연결해체 인디케이션을 하도록 요구한다.

IRP

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

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

    STATUS_SUCCESS
    STATUS_PENDING
    STATUS_INVALID_CONNECTION
    STATUS_REQUEST_TIMED_OUT

    IrpSp->MajorFunction
    IRP_MJ_INTERNAL_DEVICE_CONTROL을 설정한다. 트랜스포트가 TDI_XXX 리퀘스트만을 다루는 TdiDispatchInternalDeviceControl 루틴을 익스포트한다면 이 멤버를 무시할 수 있다,

    IrpSp->MinorFunction
    TDI_DISCONNECT를 서술한다.

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

    IrpSp->Parameters
    TDI_REQUEST_KERNEL 구조체와 대등한 TDI_REQUEST_KERNEL_DISCONNECT 구조체를 가리킨다.

    몇몇 트랜스포트 드라이버는 주어진 연결에서 즉시 모든 동작을 종료한다. 나머지는 통제된 연결해체를 지원하기 위해서 RequestFlags 멤버의 클라이언트 제공 값을 사용한다. 그러한 트랜스포트를 위해서 RequestFlags는 다음중에 하나로 설정될 수 있다:

    TDI_DISCONNECT_ABORT
    트랜스포트가 연결상에서 지연된 연산의 완료없이 즉시 연결을 닫아야한다는 것을 서술한다. 이것은 통제된 연결해체를 지원하지 않는 트랜스포트를 포함하여 모든 트랜스포트에게 기대되는 기본적인 행동이다. 결과적으로 RequestFlags에 대한 이 값은 RequestFlags 값이 0 인것처럼 트래스포트가 똑같은 것을 하도록 지시한다: 트랜스포트는 연결을 위해서 들어오는 리퀘스트를 거절해야하고 특정 연결 엔드포인트에서의 모든 동작을 멈추게 해서 연결을 위해서 내부적으로 큐에 유지되는 특정 리퀘스트를 취소해야한다.

    전에 TDI_DISCONNECT_RELEASE를 가지고 행해진 연결해체 리퀘스트가 연결상에서 지연된 처리를 가지고 있다면 클라이언트는 TDI_DISCONNECT_ABORT를 가지고 또다른 연결해체 리퀘스트를 제시할 수 있다. 그래서 하부의 트랜스포트가 연결을 즉시 닫도록 강요한다.

    TDI_DISCONNECT_RELEASE
    나중에 주석에서 설명한 것처럼 트랜스포트가 연결해체를 시작하거나 원격지로부터 시작된 통제된 연결해체를 확실히 해야한다는 것을 서술한다.

    원격지상에 있는 트랜스포트에게로 트랜스포트 제공 상태 정보로 보완되는 연결해체 데이타를 제공하기 위해서 트랜스포트는 RequestConnectionInformation에 버퍼안에 클라이언트 제공 정보를 사용한다. 이 버퍼는 TDI_CONNECTION_INFORMATION 구조체로써 포맷된다.

    트랜스포트는 연결해체 데이타를 리턴할 수 있고 ReturnConnectionInformation에 클라이언트 제공 버퍼에 원격지의 트랜스포트에 의해서 제공되는 상태 정보를 리턴할 수 있다. 이 버퍼는 TDI_CONNECTION_INFORMATION 구조체로써 포맷된다. 클라이언트가 순차적인 TDI_LISTEN 혹은 TDI_CONNECT 리퀘스트에서 연결을 재사용할 때까지 이 버퍼의 내용은 유효하다.

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

    IrpSp->Parameters.RequestSpecific
    연결해체 연산에 대한 타임아웃 간격을 서술하는 LARGE_INTEGER 변수를 가리키거나 혹은 NULL을 가리킨다. 명확한 타이아웃은 타임아웃 간격을 위해서 현재 시스템 시간과 관련된 음의 100 나노초 유닛으로 서술된다. 이 멤버가 NULL이라면 트랜스포트는 1초보다 작은 값으로 적절한 타임아웃 값을 선택해야한다.

주석

연결해체 연산동안에 하부의 트랜스포트 드라이버는 성립된 연결을 위해서 들어오는 리퀘스트를 재사용한다. 그리고 트랜스포트가 통제된 연결해체를 지원하지 않는다면 특정 연결 엔드포인트에서 모든 동작을 멈춘다. 즉 클라이언트의 연결해체 리퀘스트 완료는 주어진 연결상에서 리시브 인디케이션을 포함하는 모든 동작의 중단을 의미한다.

기본적으로 TDI_DISCONNECT는 통제된 연결해체 연산이 아닌 엔드포인트 대 엔드포인트 연결의 연결해체를 리퀘스트한다: 트랜스포트는 연결해체 리퀘스트를 완료하고 통제를 리턴하기 전에 연결상에서 특정 I/O 리퀘스트를 완료할 필요가 없다. 그러한 연결해체 연산을 위해서 트랜스포트는 전형적으로 주어진 연결에서 모든 특정 리퀘스트를 취소한다. 그리고 대응하는 원격의 트랜스포트는 로컬의 트랜스포트가 클라이언트의 연결해체 리퀘스트를 완료하고 통제를 리턴하기 전에 클라이언트로 하여금 연결해체를 확실히 할 필요가 없다.

엔드포인트 대 엔드포인트 연결에서 클라이언트는 하부의 TDI 트랜스포트가 이것을 지원한다면 통제된 연결해체를 리퀘스트할 수 있다. 그렇다면 TDI_DISCONNECT 리퀘스트를 가지고 연결해체 연산을 시작하는 클라이언트는 원격지에게 엔드포인트 대 엔드포인트 연결리 닫힌다는 것을 알리기 위해서 그들의 연산에 동등한 양쪽의 트랜스포트를 야기할 수 있다. 이러한 상황에서 원격의 클라이언트는 하부의 트랜스포트가 연결해체 리퀘스트를 시작하는 로컬의 클라이언트로부터 리턴되기 전에 연결해체를 확실히 해야한다.

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

  1. 로컬의 클라이언트는 RequestFlags안에 설정된 TDI_DISCONNECT_RELEASE를 가지고 연결해체 리퀘스트를 하므로써 연결해체를 시작한다. 결과적으로 이 클라이언트는 연결상에서 데이타를 더 이상 보낼 수 없지만 원격지로부터 데이타 수신을 계속할 수 있다. 그러한 로컬의 클라이언트가 연결해체 리퀘스트를 할 때 하부의 트랜스포트는 현재 유지하고 있는 지연된 보내기 리퀘스트를 위한 데이타를 전송한다. 그리고 클라이언트로 다시 이 리퀘스트를 완료한다. 그리고 연결해체가 발생하는 원격의 트랜스포트에게 통보한다.

  2. 원격지의 트랜스포트는 클라이언트에 의해서 행해진 지연된 리시브 리퀘스트를 위해서 평범한 연산을 수행한다. 그런데 ClientEventDisconnect 핸들러를 등록했다면 이 함수를 호출하므로써 혹은 클라이언트에 의해서 행해진 특정 리퀘스트에 대한 에러 코드를 리턴하므로써 원격의 클라이언트는 클라이언트의 지연된 연결해체를 통보한다. 그러한 통보 후에 원격의 클라이언트는 연결상에서 더 이상 데이타를 받을 수 없지만 RequestFlags에 설정된 TDI_DISCONNECT_RELEASE를 가지고 TDI_DISCONNECT 리퀘스트를 할 때까지 계속 데이타를 보낼 수 있다.

  3. 원격의 클라이언트가 데이타 전송을 마쳤을 때 원격의 클라이언트는 RequestFlags에 설정된 TDI_DISCONNECT_RELEASE를 가지고 하부의 트랜스포트로 연결해체 리퀘스트를 한다. 클라이언트의 연결해체 리퀘스트를 완료하기 전에 트랜스포트는 연결상에서 모든 특정 보내기를 완료한다. 트랜스포트가 이 연결해체 리퀘스트를 완료할 때 연결은 원격지의 관점에서 볼 때 닫힌다. 그러나 연결 엔드포인트는 아직도 유효하고 클라이언트는 나중에 다시 사용할 수 있다.

  4. 원격의 트랜스포트는 원격지생에서의 연결해체를 확실히 하기 위해서 로컬의 트랜스포트에게 통보한다. 이 시점에서 원래의 연결해체 리퀘스트는 로컬의 트랜스포트에 의해서 완료되고 연결은 연결해체를 시작하는 로컬의 클라이언트 관점에서 닫힌다. 그러나 연결은 아직도 유효하고 클라이언트는 다시 사용할 수 있다.

하부의 트랜스포트가 지연된 연결 승인을 지원한다면 클라이언트는 원격지에서 제공된 들어오는 연결을 거절하기 위해서 TDI_DISCONNECT 리퀘스트를 제출할 수 있다. 그러한 클라이언트는 클라이언트가 TDI_QUERY_ACCEPT 플래그를 설정한 완료된 TDI_LISTEN 리퀘스트에 대해서 응답하거나 등록된 클라이언트의 ClientEventConnect 핸들러로 트랜스포트에 의해서 다시 놓인 제공에 대한 응답이다.

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