TDI_SEND_DATAGRAM

커널 모드 클라이언트가 TDI_SEND_DATAGRAM 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버에게 명시된 원격지의 주소로 데이타그램으로써 TSDU를 전송하도록 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_PENDING
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_ADDRESS
STATUS_INVALID_PARAMETER

Irp->IoStatus.Information

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

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_SEND_DATAGRAM을 서술한다.

IrpSp->FileObject

로컬 주소를 구현하는 열린 파일 객체를 가리킨다. 트랜스포튼 이 주소에 대해서 유지하는 상태로 접근하기 위해서 FsContext와 가능하다면 FsContext2 필드를 사용한다.

IrpSp->Parameters

다음과 같이 정의되는 TDI_REQUEST_KERNEL_SENDDG 구조체를 가리킨다:

struct _TDI_REQUEST_KERNEL_SENDDG {

    ULONG SendLength;

    PTDI_CONNECTION_INFORMATION SendDatagramInformation;

} TDI_REQUEST_KERNEL_SENDDG, *PTDI_REQUEST_KERNEL_SENDDG;

트랜스포트는 다음과 같이 구조체의 멤버를 사용한다:

SendLength

보내지는 데이타그램의 바이트 수를 서술한다.

SendDatagramInformation

로컬의 클라이언트가 데이타그램을 보내고자하는 원격의 주소를 서술하는 TDI_CONNECTION_INFORMATION 구조체를 가리킨다.

Irp->MdlAddress

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

주석

TDI 트랜스포트는 단편화된 데이타그램을 보내지 않는다. 결국 클라이언트는 비연결지향 데이타 전송 연산에서 특정 리퀘스트와만 연관된 각각의 보내기 데이타그램에서 하나를 행한다.

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

TDI_QUERY_PROVIDER_INFO, TDI_QUERY_DATAGRAM_INFO, 혹은 TDI_QUERY_MAX_DATAGRAM_INFO로 설정된 QueryType을 가지고 쿼리 정보 리퀘스트를 제출하므로써 클라이언트는 트랜스포트의 보내기 사이즈 제한을 결정할 수 있다.

트랜스포트는 길이가 0인 데이타그램의 전송을 클라이어트에게 허락한다. 예를들어 길이가 0인 보내기 데이타그램 리퀘스트는 프로토콜 흐름을 강요한다.

몇몇 트랜스포트는 클라이언트에게 데이타그램을 원격지의 멀티캐스트 혹은 브로드캐스트 주소로 지시하는 것을 허락한다. 그러한 멀티캐스트 혹은 브로드캐스트 주소의 신택스는 트랜스포트 특정이다.

비연결지향 전송으로써 데이타그램 전송은 원래 비신뢰적이다. 트랜스포트는 드라이버 개발자의 결정에서 데이타그램을 복사하거나 드랍할 수 있다. 트랜스포트는 성공이든 에러이든지 간에 적절한 방법으로 각각의 보내기 데이타그램 IRP를 완료해야한다. 드라이버는 하부 네트웍 상태의 지식에 기반하여 적당한 타임아웃을 결정해야한다.

드라이버가 내부적으로 데이타그램을 큐에 저장한다면 트랜스포트는 FIFO 순서로 보내기 데이타그램 리퀘스트를 처리해야한다. 보내기 데이타그램 리퀘스트는 엔드포인트 대 엔드포인트 보내기 리퀘스트로부터 분리되어 큐에 저장되어야한다.

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