TdiBuildReceiveDatagram

VOID
   TdiBuildReceiveDatagram (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN PMDL MdlAddr,
       IN ULONG ReceiveLen,
       IN PTDI_CONNECTION_INFORMATION ReceiveDatagramInfo,
       OUT PTDI_CONNECTION_INFORMATION ReturnInfo,
       ULONG InFlags
      );

TdiBuildReceiveDatagram 함수는 로컬 클라이언트가 주소를 구현하는 파일 객체를 이미 연 하부의 트랜스포트로 TDI_RECEIVE_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을 가리킨다.

ReceiveLen

MdlAddr에 맵된 버퍼로 리턴되는 데이타그램의 최대 바이트 사이즈를 서술한다. 이 매개변수가 0이면 트랜스포트는 MdlAddr에 맵된 전체 버퍼를 사용할 수 있다.

ReceiveDatagramInfo

로컬 클라이언트가 받아들이는 데이타그램으로부터 특정 원격의 주소를 서술하는 TDI_CONNECTION_INFORMATION 구조체를 가리킨다. RemoteAddressLength 멤버가 0이면 원격지로부터의 데이타그램은 이 클라이언트로 들어올 수 있다. RemoteAddressLength가 0이면 RemoteAddress가 NULL로 설정됐음을 의미한다.

ReturnInfo

트랜스포트가 TDI_CONNECTION_INFORMATION 구조체로써 포맷된 리시브된 데이타그램의 근원지 주소를 리턴하는 호출자 제공 버퍼를 가리킨다.

InFlags

다음의 것으로 하나 혹은 그 이상으로 OR 연산되므로써 트랜스포트에 의해서 리턴되는 리시브의 타입을 서술한다:

TDI_RECEIVE_NORMAL

클라이언트 제공 버퍼로 정상적인 TSDU를 리턴한다.

TDI_RECEIVE_PEEK

TSDU가 부분적이고 클라이언트가 데이타그램의 나머지를 위해서 또다른 리시브를 리퀘스트한다고 하더라도 원격지로부터 도착하자마자 인디케이트된 데이타그램을 리턴한다.

이 플래그는 하부의 트랜스포트가 내부적으로 리시브된 데이타그램을 버퍼화할 때만 유효하다. 일반적으로 클라이언트는 버퍼화되지 않은 트랜스포트를 위해서 내부적으로 데이타를 버퍼화하는 시스템 AFD 드라이버를 지난 클라이언트는 이 플래그를 사용할 수 있다.

주석

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

데이타그램이 성립된 연결과 연관되지 않았기 때문에 TDI 드라이버는 데이타그램에 따라서 리시브하는 클라이언트로 원격의 전송자에 대한 트랜스포트 주소를 리턴한다.

트랜스포트가 ReceiveDatagramInfo에서 클라이언트 사양과 일치하는 근원지 주소와 클라이언트의 열린 파일 객체에 의해서 구현된 로컬 주소를 지시하는 데이타그램을 받을 때 트랜스포트는 이 IRP를 만족시킨다. 리시브된 데이타그램이 클라이언트 제공 버퍼에 대해서 너무 크다면 하부의 트랜스포트는 데이타그램의 끝을 자름으로써 불필요한 데이타를 버리고 클라이언트의 리시브 데이타그램 리퀘스트를 완료한다.

TDI 트랜스포트는 데이타그램을 결코 단편화하지 않는다. 결국 그들의 클라이언트는 각각의 데이타그램을 리시브하기 위해서 하나의 리시브 데이타그램 리퀘스트를 한다. ReceiveLen에 대한서 가능한 최대 값을 결정하기 위해서 클라이언트는 보통 앞서 QType이 TDI_QUERY_PROVIDER_INFO, TDI_QUERY_DATAGRAM_INFO, 혹은 TDI_QUERY_MAX_DATAGRAM_INFO인 것에 대해서 TdiBuildQueryInformation 함수를 가지고 설정된 정보 쿼리 리퀘스트를 제시했다.

클라이언트는 정보 쿼리 리퀘스트를 가지고 얻을 수 있는 트랜스포트 특정 포맷을 가지는 브로드캐스트 주소를 열어서 브로드캐스트 데이타그램을 받을 수 있다. 그러나 그러한 클라이언트는 브로드캐스트 주소로부터 데이타그램을 보낼 수 없다. 그리고 자신의 연결과 그 브로드캐스트 주소사이에서 연결을 성립할 수 없다.

또한 클라이언트는 특정 주소 상에서 ClientEventReceiveDatagram과 ClientEventChainedReceiveDatagram 함수를 등록하므로써 데이타그램을 받을 수 있다.