TDI_RECEIVE_DATAGRAM

커널 모든 클라이언트가 TDI_RECEIVE_DATAGRAM 리퀘스트를 행할 때 커널 모드 클라이언트는 특정 주소상에서 데이타그램으로써 TSDU를 인디케이트하기 위해서 하부의 TDI 트랜스포트 드라이버에게 요구한다.

IRP

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

Irp->IoStatus.Status

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

STATUS_PENDING
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_ADDRESS
STATUS_BUFFER_OVERFLOW
STATUS_BUFFER_TOO_SMALL

Irp->IoStatus.Information

트랜스포트가 클라이언트 제공 버퍼로 요구하는 리시브된 데이타의 바이트 수를 서술한다.

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_RECEIVE_DATAGRAM을 서술한다.

IrpSp->FileObject

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

IrpSp->Parameters

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


struct _TDI_REQUEST_KERNEL_RECEIVEDG {

    ULONG ReceiveLength;

    PTDI_CONNECTION_INFORMATION ReceiveDatagramInformation;

    PTDI_CONNECTION_INFORMATION ReturnInformation;

    ULONG ReceiveFlags;

} TDI_REQUEST_KERNEL_RECEIVEDG, *PTDI_REQUEST_KERNEL_RECEIVEDG;

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

ReceiveLength: 클라이언트 제공 리시브 버퍼의 최대 바이트 사이즈를 서술한다. 이 멤버가 0이면 트랜스포트는 Irp->MdlAddress에 맵된 전체 버퍼를 사용할 수 있다.
ReceiveDatagramInformation: 클라이언트가 데이타그램을 수신하기를 기대하는 원격지의 주소를 서술하거나 원격지로부터의 데이타그램이 이 클라이언트에서 승인된다면 RemoteAddressLength 멤버에 0을 서술하는 TDI_CONNECTION_INFORMATION 구조체를 가리킨다.
ReturnInformation: 리턴되는 데이타그램의 리시브로부터 원격지의 주소를 리턴하는 트랜스포트 안에 TDI_CONNECTION_INFORMATION 구조체로써 포맷된 호출자 제공 버퍼를 가리킨다.
ReceiveFlags: 0이나 하나 혹은 다음의 플래그 결합(OR 연산)으로 클라이언트가 기대하는 데이타그램의 타입을 서술한다:
TDI_RECEIVE_NORMAL - 정상적인 데이타그램을 리턴해라.
TDI_RECEIVE_PEEK - 데이타그램의 사용가능한 부분을 리턴해라.
Irp->MdlAddress: 리시브된 데이타그램을 리턴하는 트랜스포트의 클라이언트 제공 버퍼를 매핑하는 체인에서 가능하다면 처음 MDL을 가리킨다.

주석

데이타그램은 엔드포인트 대 엔드포인트 연결과는 무과하기 때문에 트랜스포트는 각각의 데이타그램을 따라서 리시브하는 클라이언트로 원격지 클라이언트의 주소를 리턴해야한다.

TDI 트랜스포트는 데이타그램을 단편화하지 않는다. 결국 클라이언트는 TDI_RECEIVE_PEEK 플래그가 설정되지 않는다면 전체 데이타그램을 위해서 하나의 리시브 데이타그램 리퀘스트를 한다. TDI 트랜스포트 드라이버가 원격지로부터 데이타그램을 받을 때 다음의 내용이 사실이라면 클라이언트의 리시브 데이타그램 리퀘스트를 완료한다:

방금 리시브된 데이타그램이 IrpSp->FileObject에 파일 객체에 의해서 구현되는 로컬 주소와 일치하는 목적지 주소를 가지고 있다.

방금 리시브된 데이타그램이 IrpSp->Parameters에 RemoteAddress안에 서술된 값과 일치하는 근원지 주소를 가지고 있거나 RemoteAddressLength가 0이고 RemoteAddress가 NULL이다.

리시브된 데이타그램이 Irp->MdlAddress에 맵된 클라이언트 제공 버퍼에 대해서 너무 크다면 트랜스포트는 이 버퍼를 ReceiveLength 바이트를 가지고 채우고 클라이언트의 리시브 데이타그램 IRP를 완료한다. 결과적으로 클라이언트는 리시브 데이타그램 리퀘스트를 가지고 충분히 큰 버퍼를 제공하지 않는다면 끝이 잘린 데이타그램을 받는다.

또한 로컬 클라이언트는 특정 주소에 대해서 ClientEventReceiveDatagram 혹은 ClientEventChainedReceiveDatagram 핸들러를 등록하기 위해서 TDI_SET_EVENT_HANDLER 리퀘스트를 제시하므로써 데이타그램을 받을 수 있다. TDI_RECEIVE_EXPEDITED를 제외한 TDI_RECEIVE에 대한 레퍼런스에 리스트된 플래그들을 가지고 ClientEvent(Chained)ReceiveDatagram 함수에 ReceiveDatagramFlags 매개변수를 설정하므로써 트랜스포트는 클라이언트로 이 정보를 제공한다. 게다가 데이타그램 인디케이션을 위해서 ReceiveDatagramFlags는 다음중 하나로 설정될 수 있다:

TDI_RECEIVE_BROADCAST: 리시브된 TSDU가 브로드캐스트이다.
TDI_RECEIVE_MULTICAST: 리시브된 TSDU가 멀티캐스트이다.

TDI 클라이언트는 하부 트랜스포트의 브로드캐스트 주소를 구현하는 파일 객체를 열어서 브로드캐스트 데이타그램을 받을 수 있다. 어떤 브로드캐스트 주소는 클라이언트가 하부의 트랜스포트로 TDI_QUERY_INFORMATION 리퀘스트를 제세하므로써 얻을 수 있는 드라이버 특정 포맷을 가진다. 트랜스포트는 클라이언트로 하여금 브로드캐스트 주소로부터 데이타그램을 보내도록 허락하지 않는다. 그리고 트랜스포트는 브로드캐스트 주소를 서술하는 클라이언트 제시 TDI_ASSOCIATE_ADDRESS 리퀘스트를 실패한다.

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