TdiBuildSendDatagram

VOID
   TdiBuildSendDatagram (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN PMDL MdlAddr,
       IN ULONG SendLen,
       IN PTDI_CONNECTION_INFORMATION SendDatagramInfo
      );

TdiBuildSendDatagram 함수는 로컬 클라이언트가 주소를 구현하는 파일 객체를 이미 연 하부의 트랜스포트로 TDI_SEND_DATAGRAM 리퀘스트를 위한 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

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

DevObj

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

FileObj

주소를 구현하는 파일 객체를 가리킨다.

CompRoutine

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

Contxt

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

MdlAddr

트랜스포트가 보내지는 데이타그램을 전송하는 클라이언트 제공 버퍼를 매핑하는 체인화된 MDL의 처음 MDL을 가리킨다.

SendLen

MdlAddr에 맵된 버퍼의 바이트 사이즈를 서술한다. 최대 데이타그램 사이즈는 하부의 트랜스포트에 의존한다. ㅐ이 유효한 값인지 또한 하부의 트랜스포트에 의존한다.

SendDatagramInfo

호출자 제공 데이타그램이 보내지는 원격지의 주소를 서술하는 TDI_CONNECTION_INFORMATION 구조체를 가리킨다.

주석

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

TDI 트랜스포트는 결코 데이타그램을 단편화할 수 없다. 결국 그들의 클라이언트는 주어진 목적지 주소로 비연결지향 데이타 전송을 위해서 특정 리퀘스트 만을 가지고 연관되는 각각의 데이타그램을 전송하기 위해서 한번의 데이타그램 보내기 리퀘스트를 한다. SendLen을 위해서 가능한 최대의 값을 결정하기 위해서 클라이언트는 보통 QType의 값이 TDI_QUERY_PROVIDER_INFO, TDI_QUERY_DATAGRAM_INFO, 혹은 TDI_QUERY_MAX_DATAGRAM_INFO인 것에 대해서 TdiBuildQueryInformation 함수를 가지고 설정된 정보 쿼리 리퀘스트를 제시한다.

어떤 비연결지향 전송은 원래 비신뢰적이다. 하부의 트랜스포트는 트랜스포트 드라이버 개발자의 결정에서 주어진 데이타그램을 손실하거나 복사할 수 있다.

클라이언트가 데이타그램 보내기 리퀘스트를 제시할 때 트랜스포트는 내부적으로 리퀘스트를 큐에 저장한다. 그러한 트랜스포트는 FIFO 순서로 데이타그램 보내기 리퀘스트를 처리한다. 그들은 같은 클라이언트에서 엔드포인트 대 엔드포인트 보내기 리퀘스트로부터 분리된 데이타그램 보내기 리퀘스트를 큐에 저장한다.