TdiBuildSend

VOID
   TdiBuildSend (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN PMDL MdlAddr,
       IN ULONG InFlags,
       IN ULONG SendLen
      );

TdiBuildSend 함수는 로컬 클라이언트가 연결 엔드포인트를 구현하는 파일 객체를 이미 열었고 원격지와 엔드포인트 대 엔드포인트 연결을 성립한 하부의 트랜스포트로 TDI_SEND 리퀘스트를 위해서 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

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

DevObj

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

FileObj

연결 엔드포인트를 구현하는 파일 객체를 가리킨다.

호출자는 이 연결 엔드포인트와 로컬 주소사이에 관계를 설정하기 위해서 트랜스포트로 TdiBuildAssociateAddress 함수를 가지고 설정된 리퀘스트를 전에 성공했다. 관계가 성립됐을 때 호출자는 또한 TdiBuildConnect나 TdiBuildListen 함수를 가지고 설정된 리퀘스트를 성공적으로 제시하고 후에 TdiBuildAccept 함수를 가지고 설정된 리퀘스트를 성공하므로써 원격지와 엔드포인트 대 엔드포인트 연결을 성립한다.

CompRoutine

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

Contxt

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

MdlAddr

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

InFlags

데이타가 어떻게 전송되는지를 서술한다.이 매개변수가 0이면 트랜스포트는 정상적인 TSDU로써 주어진 데이타를 보내야한다. 그렇지 않으면 이 매개변수는 다음의 플래그로 OR 연산될 수 있다:

TDI_SEND_EXPEDITED

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

TDI_SEND_PARTIAL

주어진 데이타는 레코드의 끝으로써 종결된다. 하지만 완료된 메세지 모드의 TSDU는 아니다. 클라이언트는 나중에 추가된 데이타를 보낼 것이다. 이 플래그는 스트림 모드 트랜스포트의 클라이언트와는 무관하다.

TDI_SEND_NO_RESPONSE_EXPECTED

호출자는 워격지로부터의 이 보내기에 대한 응답을 기대하지 않는 하부의 트랜스포트에게 힌트를 주고있다. 클라이언트는 트랜스포트가 이런 최적화를 지원한다고 가정하고 원격의 트랜스포트에 의해서 승인된 TSDU의 피기백을 디스에이블하기 위해서 이 플래그를 사용한다. 그렇지 않으면 하부의 트랜스포트는 원격지로부터 보내기의 피기백 승인을 위해서 기다림으로써 타임아웃한다.

TDI_SEND_NON_BLOCKING

하부의 트랜스포트가 주어진 데이타를 위해서 현재 사용가능한 내부의 버퍼공간을 가지고 있지 않다면 내부적으로 주어진 데이타를 버퍼화할 수 있을 때까지 블러킹하기보다는 STATUS_DEVICE_NOT_READY를 가지고 보내기 리퀘스트를 실패해야한다. 트랜스포트는 보내기를 위해서 사용가능한 내부의 버퍼 공간을 다시 가질 때 ClientEventSendPossible 핸들러를 호출해야한다. 이 플래그는 내부적으로 버퍼화하지 않는 트랜스포트의 클라이언트와는 무관하다.

SendLen

MdlAddr에 맵된 버퍼의 바이트 사이즈를 서술한다. 이 매개변수에 대한 최대값은 하부 트랜스포트에 의존한다. 0이 유효한지도 하부의 트랜스포트에 의존한다.(주석을 봐라.)

주석

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

TdiBuildSend 함수를 가지고 설정된 각각의 보내기 리퀘스트에서 호출자는 원격지로 보내지는 TSDU를 포함하는 버퍼를 제공하거나 하부의 트랜스포트가 메세지 모드의 전송을 지원한다면 부분적인 TSDU를 포함하는 버퍼를 제공한다. 클라이언트는 TDI 드라이버가 허락하는 최대 사이즈로 데이타의 양을 보낼 수 있다. 보내기에 대한 트랜스포트 특정 최대 값을 얻기 위해서 클라이언트는 TdiBuildQueryInformation 함수를 가지고 설정된 TDI_QUERY_PROVIDER_INFO 리퀘스트를 할 수 있다.

TdiBuildSend 함수의 호출자가 IoCallDriver 함수를 가진 하부의 트랜스포트로 보내기 IRP를 전달한 후에 MdlAddress에 클라이언트 제공 버퍼는 보내기 연산이 완료될 때까지 클라이언트로 접근할 수 없다. IRP가 클라이언트의 IoCompletion 루틴으로 리턴하거나 클라이언트가 그 버퍼안에 데이타를 위해서 하부의 트랜스포트가 보내기 연산을 완료했음을(프로토콜의 의미구조를 통해서) 확신할 때까지 클라이언트는 보내기 버퍼를 사용하거나 바꾸는 시도를 할 수 없다.

로컬의 트랜스포트는 내부적으로 몇몇 보내기 리퀘스트를 큐에 저장할 수 있다. 하지만 항상 FIFO 순서로 그들을 전송한다. 트랜스포트가 신속한 보내기를 지원한다면 트랜스포트는 현재 유지하는 정상적인 보내기의 선두에서 들어오는 신속한 보내기 리퀘스트를 FIFO 순서로 큐에 저장한다. 트랜스포트는 성공 혹은 에러 상태를 가지고 적절한 방법으로 들어오는 보내기를 완료할 책임이 있다. 트랜스포트는 현재 네트웍 상태에 대해서 정당한 타임아웃 간격의 드라이버 결정 판단에 근거한 타임아웃 에러를 가지고 보내기를 완료할 수 있다.

엔드포인트 대 엔드포인트 연결상에서 로컬 클라이언트의 각각의 보내기 리퀘스트는 다음중 하나와 대응한다:

• 하부의 TDI 트랜스포트로 원격의 클라이언트에 의해서 제시된 하나의 리시브 리퀘스트.
• 하부의 TDI 트랜스포트에 의해서 원격 클라이언트의 등록된 ClientEventReceive, ClientEventReceiveExpedited, ClientEventChainedReceive, 혹은 ClientEventChainedReceiveExpedited 핸들러로의 한번의 호출.

TdiBuildSend 함수의 호출자는 하부의 트랜스포트가 클라이언트 보내기 데이타를 복사하는 내부의 버퍼를 갖는다면 TDI_SEND_NON_BLOCKING 플래그를 설정하므로써 비블러킹 보내기를 리퀘스트할 수 있다. 사용가능한 내부버퍼의 양에 의존하여 하부의 트랜스포트는 다음과 같이 보내기 리퀘스트를 처리한다:

• 트랜스포트가 충분한 내부 버퍼공간을 갖는다면 트랜스포트는 클라이언트 제공 버퍼로부터 데이타를 복사하고 STATUS_SUCCESS를 가지고 보내기 IRP를 완료한다.
• 트랜스포트가 주어진 SendLength에 대해서 현재 불충분한 버퍼 공간을 갖는다면 트랜스포트는 클라이언트 버퍼로부터 가능한 한 많은 데이타를 복사하고 STATUS_SUCCESS를 리턴한다.
• 드라이버가 현재 내부의 버퍼공간을 가지고 있지 않다면 트랜스포트는 STATUS_DEVICE_NOT_READY를 가지고 보내기 IRP를 완료한다.

  그러한 트랜스포트의 클라이언트는 ClientEventSendPossible 핸들러를 등록한다. 그래서 트랜스포트는 거절된 보내기를 위해서 사용할 수 있는 내부의 버퍼공간을 다시 가질 때 이 함수를 호출할 수 있다.

몇몇 트래스포트는 그들의 클라이언트로 하여금 길이가 0인 보내기 리퀘스트를 허락한다. 그러한 트랜스포트를 위해서 길이가 0인 보내기는 실제로 TDI_SEND_PARTIAL 플래그가 클리어상태인 한 프로토콜을 순환하도록한다. 트랜스포트의 클라이언트는 리시브 리퀘스트를 만족시키는 메세지로써 길이가 0인 보내기를 제시할 수 있다. 이런 특징을 지원하지 않는 트랜스포트는 클라이언트가 길이가 0인 보내기 리퀘스트를 제시할 때 에러를 리턴한다.

또한 TDI 클라이언트는 ZwWriteFile 함수로의 호출을 가지고 엔드포인트 대 엔드포인트 연결 상에서 정상적인 TSDU를 보낼 수 있다. 이 루틴은 TDI_SEND_XXX 플래그의 사양을 허락하지 않기 때문에 SendFlags안에 클리어된 TDI_SEND_PARTIAL와 TDI_SEND_EXPEDITED를 가지고 TdiBuildSend 함수의 리퀘스트로써 패키지화된 것처럼 ZwWriteFile 함수에게 주어진 클라이언트 제공 데이타는 하부의 트랜스포트에 의해서 전송된다. 트랜스포트는 MdlAddr에 버퍼안에 모든 데이타가 보내져야하고 호출자의 ZwWriteFile 함수에 대한 ByteOffset과 Key 인자는 무시됐다고 가정한다.

ZwWriteFile과 IoCallDriver 함수 호출에 대한 특징에 대해서는 커널 모드 드라이버 레퍼런스를 봐라.