TDI_SEND

커널 모드 클라이언트가 TDI_SEND 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버로 하여금 원격지의 명시된 연결 엔드포인트상에서 정상적이거나 신속한 TSDU를 전송하도록 요구한다.

IRP

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

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

    STATUS_SUCCESS
    STATUS_PENDING
    STATUS_INVALID_CONNECTION
    STATUS_INVALID_PARAMETER
    STATUS_DEVICE_NOT_READY

    Irp->IoStatus.Information
    Irp->MdlAddress에 맵된 클라이언트 제공 버퍼로부터 전송된 클라이언트 제공 데이타의 바이트 수를 서술한다.

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

    IrpSp->MinorFunction
    TDI_SEND를 서술한다.

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

    클라이언트는 이 연결 엔드포인트상에서 원격지와 이미 엔드포인트 대 엔드포인트 연결을 성립했다.

    IrpSp->Parameters
    다음과 같이 정의되는 TDI_REQUEST_KERNEL_SEND 구조체를 가리킨다: 
    
struct _TDI_REQUEST_KERNEL_SEND {

    ULONG SendLength;

    ULONG SendFlags;

} TDI_REQUEST_KERNEL_SEND, *PTDI_REQUEST_KERNEL_SEND;
    트랜스포트는 다음과 같이 이 구조체의 멤버를 사용한다:

    SendLength
    Irp->MdlAddress에 맵된 버퍼로 보내진 데이타의 바이트 수를 서술한다.

    SendFlags
    클라이언트가 0, 하나혹은 OR 연산된 TDI_SEND_XXX 플래그(주석을 봐라)로써 보내지도록 기대되는 TSDU의 타입을 서술한다.

    Irp->MdlAddress
    보내질 데이타를 포함하는 클라이언트 제공 버퍼를 매핑하는 체인안에 처음 MDL을 가리킨다.

주석

클라이언트가 이 IRP를 설정하기 위해서 TdiBuildSend 함수를 호출할 때 클라이언트는 원하는 보내기 타입을 서술할 수 있다. 트랜스포트는 SendFlags 멤버안에 IrpSp->Parameters에 정보를 찾는다. 입력에서 SendFlags는 0을 수 있거나 다음 플래그들의 OR 연산 결합으로써 설정될 수 있다:

TDI_SEND_EXPEDITED
주어진 데이타는 트랜스포트가 엔드포인트 대 엔드포인트 연결에서 전송을 위해서 큐를 현재 유지하고 있는 정상적인 보내기 리퀘스트의 앞부분이 보내져야한다. 트랜스포트가 신속한 전송을 지원하지 않는다면 이 플래그를 무시할 수 있다.

TDI_SEND_PARTIAL
주어진 데이타는 완료된 메세지 모드 TSDU가 아니다. 클라이언트는 TSDU를 위해서 나중에 남아있는 데이타를 보낼 것이다. 이 플래그는 스트림 모드 트랜스포트와 무관하다.

이 플래그가 메세지 모드 트랜스포트로 제시된 보내기에서 클리어된다면 드라이버는 클라이언트의 버퍼에서 제공된 모든 데이타를 보낸 후에 라인 플로우 안으로 레코드표시의 끝을 삽입한다.

TDI_SEND_NO_RESPONSE_EXPECTED
호출자는 원격지로부터 이 보내기에 대한 응답을 기대하지 않는 하부의 트랜스포트에게 힌트를 주고있다. 이 플래그는 원격지 트랜스포트에 의해서 TSDU 승인의 피기백을 디스에이블 해야한다.

TDI_SEND_NON_BLOCKING
하부의 트랜스포트가 현재 주어진 데이타를 위해서 이용할 수 있는 내부의 버퍼공간을 가지고 있지 않다면 하부의 트랜스포트는 STATUS_DEVICE_NOT_READY를 가지고 IRP를 완료해야한다. 만약 트랜스포트가 약간의 버퍼 공간을 사용할 수 있다면 트랜스포트는 복사되는 바이트 수가 IoStatus.Information에 설정된 클라이언트 제공 버퍼로부터 할 수 있는 만큼 많은 데이타를 복사해야한다. 그리고 STATUS_SUCCESS를 가지고 IRP를 완료해야한다.

이 플래그는 내부적으로 보내기를 버퍼화하지 않은 트랜스포트와는 무관하다.

각각의 로컬 클라이언트의 보내기 리퀘스트는 다음중 하나와 연관이 있다:

  • 원격지의 클라이언트에 의해서 리시브 리퀘스트가 하부의 트래스포트로 제시됐다.

  • 클라이언트의 등록된 ClientEventReceive, ClientEventReceiveExpedited, ClientEventChainedReceive, 혹은 ClientEventChainedReceiveExpedited 핸들러로의 원격지 트랜스포트의 호출.

로컬 TDI 트랜스포트는 특정 연결에서 보내기 리퀘스트를 큐에 저장할 수 있다. 하지만 클라이언트가 신속한 보내기를 제시하지 않는다면 FIFO 순서로 처리해야한다. 각각의 신속한 보내기 리퀘스트는 큐에 저장되어야하고 트랜스포트가 큐에 저장하고 있는 정상적인 보내기 리퀘스트의 앞부분을 전송해야한다. 또한 각각의 신속한 보내기 리퀘스트는 클라이언트를 위해서 FIFO 순서로 전송되어야한다.

트랜스포트는 상태가 성공이든 에러이든지 간에 시기적절하게 각각의 보내기 IRP를 완료해야한다. 드라이버는 하부 네트웍 상태의 지식에 기반하여 적절한 타임아웃을 결정해야한다.

하부의 트랜스포트에 의존하여 클라이언트는 스트림 모드 혹은 메세지 모드의 TSDU를 보낼 수 있고 다음에 하나이상의 보내기 리퀘스트를 할 수 있다. 스트림 모드 트랜스포트에 대해서 클라이언트는 메세지 제한을 하지않고 TDI_SEND_PARTIAL 플래그는 무관하다. 메세지 모드 트랜스포트에 대해서 클라이언트는 각각의 TDI_SEND_PARTIAL 플래그를 서술하는 순차적인 보내기 리퀘스트로써 TSDU를 보낼 수 있다. 이 플래그가 제시된 보내기 리퀘스트에서 클리어된다면 메세지 모드 트랜스포트는 그 데이타를 순차적인 보내기의 끝이나 TSDU의 완료로 간주한다. 원격지의 TDI 트랜스포트는 대응하는 리시브 인디케이션으로 전달된 리시브 인디케이터를 통해서 수신하는 클라이언트의 부분적인 TSDU를 인식한다.

보내기 리퀘스트에서 보내는 클라이언트는 TSDU를 포함하는 버퍼를 제공한다. 클라이언트는 트랜스포트 결정 제한에 대해서 버퍼의 사이즈를 제공한다. 트랜스포트는 보내기를 완료할 때까지 이 클라이언트 제공 버퍼의 소유권을 얻는다. 트랜스포트가 지원하는 것보다 더 큰 SendLength를 서술하는 클라이언트에 대해서 트랜스포트는 보내기 리퀘스트를 실패한다.

클라이언트는 TDI_QUERY_PROVIDER_INFO 타입의 쿼리를 제시하므로써 하부 트랜스포트의 보내기 사이즈의 제한을 결정할 수 있다.

트랜스포트가 내부적으로 클라이언트 제공 보내기 데이타를 버퍼화한다면 클라이언트는 TDI_SEND_NON_BLOCKING 플래그를 설정하므로써 비블러킹 보내기를 리퀘스트할 수 있다. 그러한 트랜스포트가 설정된 이 플래그를 가지고 보내기 리퀘스트를 얻을 때 트랜스포트가 내부의 버퍼공간으로 주어진 데이타를 복사할 수 없다면 STATUS_DEVICE_NOT_READY 플래그를 가지고 IRP를 완료한다. 그러한 트랜스포트는 내부적으로 주어진 TSDU의 부분만 버퍼화한다면 STATUS_SUCCESS를 리턴한다. 하지만 내부적으로 버퍼화된 바이트의 수로 그러한 IRP안에 IoStatus.Information을 설정해야한다. 그래서 클라이언트느 원래 보내기 리퀘스트안에 유지하는 데이타에 대해서 순차적인 보내기를 제시할 수 있다.

비블러킹 보내기 리퀘스트를 제시하는 클라이언트는 보통 ClientEventSendPossible 핸들러를 등록한다. 트랜스포트는 유지하고 있는 보내기 데이타를 위해서 이용할 수 있는 내부의 버퍼공간을 갖자마자 STATUS_DEVICE_NOT_READY를 가지고 보내기 리퀘스트를 거절한 후에 하부의 트랜스포트는 이 핸들러를 호출한다.

또한 트랜스포트는 길이가 0인 보내기 리퀘스트를 지원할 수 있다. TDI_SEND_PARTIAL이 클리어된 길이가 0인 보내기는 프로토콜 흐름을 강요한다. 그러한 트랜스포트의 클라이언트는 리시브 리퀘스트를 만족시키기 위해서 길이가 0인 보내기를 제시할 수 있다. 드라이버가 길이가 0인 보내기를 지원하지 않는다면 드라이버는 클라이언트가 길이가 0인 보내기를 제시할 때 에러를 리턴한다.

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