TDI_RECEIVE

커널 모드 클라이언트가 TDI_RECEIVE 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버에게 성립된 엔드포인트 대 엔드포인트 연결상에서 정상적이거나 신속한 TSDU를 인디케이트하도록 요구한다.

IRP

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

Irp->IoStatus.Status

수신 리퀘스트의 마지막 상태를 서술한다. 트랜스포트는 IRP를 완료하기 전에 다음 중 하나의 값으로 이 멤버를 설정한다:

STATUS_PENDING
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_CONNECTION
STATUS_BUFFER_OVERFLOW

Irp->IoStatus.Information

트랜스포트가 호출자 제공 버퍼로 리턴하는 리시브된 데이타의 바이트 수를 서술한다.

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_RECEIVE를 서술한다.

IrpSp->FileObject

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

이 클라이언트는 이 연결 엔드포인트상에서 원격지와의 엔드포인트 대 엔드포인트 연결을 이미 성립시켰다.

IrpSp->Parameters

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


struct _TDI_REQUEST_KERNEL_RECEIVE {

    ULONG ReceiveLength;

    ULONG ReceiveFlags;

} TDI_REQUEST_KERNEL_RECEIVE, *PTDI_REQUEST_KERNEL_RECEIVE;

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

ReceiveLength: Irp->MdlAddress에 맵된 호출자 제공 버퍼의 바이트 사이즈를 서술한다.
ReceiveFlags: 나중에 서술(주석을 봐라)되듯이 이 클라이언트가 리퀘스트하는 리스브 타입을 서술한다.

Irp->MdlAddress

리시브된 데이타를 리턴하는 트랜스포트의 호출자 제공 버퍼를 매핑하는 체인에서 가능하다면 처음 MDL을 가리킨다.

주석

클라이언트가 이 IRP를 설정하기 위해서 TdiBuildReceive 함수를 호출할 때 클라이언트는 자신이 워하는 리스브 타입을 서술할 수 있다. 트랜스포트는 ReceiveFlags 멤버에 IrpSp->Parameters에서 이 정보를 찾는다. 입력에서 ReceiveFlags는 다으의 플래그들의 결합(OR 연산)으로 설정될 수 있고 0이 될 수도 있다:

TDI_RECEIVE_NORMAL: 트랜스포트는 이 클라이언트로 정상적인 TSDU를 리턴해야한다.
TDI_RECEIVE_EXPEDITED: 트랜스포트는 이 클라이언트로 신속한 TSDU를 리턴해야한다.
TDI_RECEIVE_PEEK: 트랜스포트는 부분적인 TSDU만이라 할지라도 내부적으로 한번에 이 클라이언트로 버퍼화되는 사용가능한 리시브 데이타를 리턴해야한다.

ReceiveFlags는 클라이언트에게 승인되는 정상적이거나 신속한 데이타의 입력에서 0이거나 TDI_RECEIVE_NORMAL과 TDI_RECEIVE_EXPEDITED를 가지고 설정된다. 이 플래그 중에 하나만 설정된다면 트랜스포트는 리퀘스트된 TSDU의 타입만을 리턴한다. 만약 TDI_RECEIVE_PEEK가 설정되면 트랜스포트는 이 클라이언트로부터 TSDU의 나머지에 대한 순차적이 리시브 리퀘스트를 기다리는 내부의 버퍼안에 데이타를 유지하고 내부적으로 버퍼화된 리시브 데이타를 리턴해야한다. TCP/IP와 SPX/IPX 같은 몇몇 트랜스포트는 데이타를 내부적으로 버퍼화하지 않는다. 그러나 윈도우즈 소켓 어플리케이션과 같은 트랜스포트 클라이언트는 시스템 AFD 드라이버로부터 버퍼화되지 않은 트랜스포트에 대한 버퍼화 지원을 얻는다.

전형적으로 트랜스포트는 원격지로부터 레코드 끝의 인디케이션을 받거나 리시브 버퍼가 채워질 때까지 정상적인 데이타를 받는다. 그러나 트랜스포트가 정상적인 데이타나 도착하는 신속한 데이타를 받고 있다면 트랜스포트는 클라이언트의 버퍼안으로 이미 전송된 정상적인 데이타를 가지고 그에 대해서 즉시 IRP를 완료하므로써 정상적인 리시브 연산을 클리어해야한다. 그리고나서 트랜스포트는 신속한 데이타에 대해서 클라이언트의 리시브 리퀘스트를 만족시켜야한다. 트랜스포트가 클라이언트로 모든 신속한 데이타를 인디케이트했을 때 트랜스포트는 다음의 리시브 리퀘스트가 그 클라이언트에 의해서 제시됐을 때 정상적인 리스브 인디케이션을 다시 시작한다.

클라이언트가 주어진 연결 엔드포인트에서의 리시브에 대해서 ClientEventReceive, ClientEventReceiveExpedited, ClientEventChainedReceive, 그리고 ClientEventChainedReceiveExpedited 핸들러를 등록했다면 트랜스포트는 리시브 IRP를 만족시킬 때까지 ClientEvent(Chained)Receive(Expedited) 루틴으로 리시브 인디케이션을 멈춘다.

클라이언트가 ClientEventReceive나 ClientEventReceiveExpedited 함수를 호출할 때 트랜스포트는 전체 TSDU가 아니라면 순차적인 TDI_RECEIVE에 대해서 클라이언트가 ReceiveFlags를 설정하기 위해서 사용할 수 있는 인디케이트되는 리시브 이벤트의 정보를 제공한다. 트랜스포트는 OR 연산된 하나이상의 다음 플래그들을 가지고 ClientEventReceive(Expedited)로 ReceiveFlags 매개변수를 설정하므로써 클라이언트에게 이 정보를 제공한다:

TDI_RECEIVE_NORMAL: 트랜스포트는 원격지로부터 정상적인 TSDU를 리시브중이다.
TDI_RECEIVE_EXPEDITED: 트랜스포트는 원격지로부터 신속한 TSDU를 리시브중이다.
TDI_RECEIVE_ENTIRE_MESSAGE: 이 플래그가 설정되면 트랜스포트는 클라이언트에 의한 수신에 대해서 사용할 수 있는 전체 TSDU를 이미 가지고 있다. 이 플래그가 설정될 때 ClientEventReceive 함수는 내부의 버퍼안으로 전체 넷 패킷을 복사하게하고 필요한 처리를 다음으로 지연하므로써 리시브된 데이타의 처리없이 통제를 리턴한다.
TDI_RECEIVE_COPY_LOOKAHEAD: 트랜스포트는 하부의 NIC 드라이버로부터 인디케이션을 위해서 lookahead 버퍼만을 리시브했다. 그래서 트랜스포트가 이 매개변수를 가지고 ClientEventReceive(Expedited) 함수를 호출할 때 BytesIndicated보다 작은 무언가로 BytesAvailable을 설정한다. 클라이언트는 내부의 버퍼안으로 BytesAvailable을 복사해야하고(TdiCopyLookaheadData 함수를 봐라) 그후에 TSDU안에 유지하는 데이타를 얻기 위해서 하나이상의 리시브 리퀘스트를 제출한다.
TDI_RECEIVE_PEEK: 트랜스포트는 내부적으로 몇몇 리시브 데이타를 버퍼화했지만아직 전체 TSDU는 아니다. 클라이언트는 TDI_RECEIVE_COPY_LOOKAHEAD가 설정된 것으로 유사한 방법으로 그러한 인디케이션을 처리한다.
TDI_RECEIVE_TRUNCATED: 트랜스포트는 끝이 잘린 TSDU를 받았다.
TDI_RECEIVE_FRAGMENT: 트랜스포트는 단편화된 TSDU를 받았다.
TDI_RECEIVE_AT_DISPATCH_LEVEL: 트랜스포트는 IRQL DISPATCH_LEVEL에서 TSDU를 리시브했다. 이 플래그는 클라이언트가 리시브 인디케이션에서 처리중에 호출할 수 있는 지원 루틴의 집합을 제한한다. 예를들어 클라이언트는 이 리시브 인디케이션의 컨텍스트에서 IRQL PASSIVE_LEVEL에서만 호출될 수 있는 TdiBuildInternalDeviceControlIrp 함수를 호출하지 않는다.

트랜스포트가 TDI_RECEIVE_NORMAL을 가지고 TDI_RECEIVE_ENTIRE_MESSAGE를 OR 연산하고 ClientEventChainedReceive 핸들러를 호출할 때 클라이언트는 입력 TsduDescriptor를 가지고 TdiReturnChainedReceives 함수를 호출할 때까지 하부 NIC의 리시브 버퍼안에 전체 TSDU로의 직접 읽기 전용 접근을 얻는다. 그러한 인디케이션에 대해서 클라이언트는 TDI_RECEIVE 리퀘스트를 제시할 필요가 없다. 결과적으로 그러한 트랜스포트는 하부의 NDIS 미니포트에서 직접 클라이언트로 다음과 같은 ClientEventChainedReceive 함수로의 최소 과부하의 매개변수 설정만을 가지고 리시브 인디케이션을 전달한다:

트랜스포트는 ClientEventChainedReceive 함수로 전달된 TsduDescriptor로써 트랜스포트 스택의 밑에서 ProtocolReceivePacket 함수로 입력되는 NDIS_PACKET 타입 디스크립터를 사용한다. 트랜스포트가 리시브 인디케이션을 전달하는 각각의 클라이언트에 대해서 트랜스포트는 ProtocolReceivePacket 함수에 의해서 리턴된 값을 1로 늘린다.

트랜스포트는 NdisGetFirstBufferFromPacket 함수를 호출하므로써 하부의 NDIS 미니포트에 의해서 제공된 패킷 디스크립터로부터 인디케이트된 데이타를 포함하는 버퍼를 얻는다. 트랜스포트는 ClientEventChainedReceive 함수에 대해서 Tsdu로써 체왼된 이 NDIS_BUFFER 타입(MDL 타입과 같다.)에 대한 포인터를 사용한다.

하부의 NDIS 미니포트에 의해서 인디케이트된 리시브 데이타의 전체 범위로부터 트랜스포트는 클라이언트에게 관심있는 서브범위를 선택한다. 드라이버는 ClientEventChainedReceive 함수에 대한 StartingOffset과 ReceiveLength로써 이 서브범위를 사용한다.

유사한 방법으로 그러한 TDI 트랜스포트는 TDI_RECEIVE_ENTIRE_MESSAGE가 입력 RequestFlags에서 TDI_RECEIVE_EXPEDITED를 가지고 OR 연산될 때 전체 TSDU로의 직접읽기 전용접근을 ClientEventChainedReceiveExpedited 함수에게 준다.

ClientEventChainedReceive(Expedited) 핸들러로 인디케이트된 TSDU에 대해서 클라이언트는 리시브 인디케이션에 대한 모든 미니포트 할당 자원의 통제를 클라이언트가 TsduDescriptor를 가지고 TdiReturnChainedReceives 함수를 호출할 때까지 유지한다. 인디케이션을 받은 각각의 클라이언트가 TdiReturnChainedReceives 함수를 호출할 때 NDIS 라이브러리는 트랜스포트 스택의 밑에서 ProtocolReceivePacket 함수에 의해서 리턴된 값으로 설정된 패킷 디스크립터에 대해서 유지하는 카운터를 줄인다. 인디케이션을 받은 모든 클라이언트가 TdiReturnChainedReceives 함수를 호출했을 때 NDIS는 이들 자원을 할당한 NDIS 미니포트로 그 패킷 디스크립터에 의해서 서술된 모든 자원의 통제를 리턴한다.

그러한 트랜스포트가 하부의 NDIS 미니포트에 의해서 행해진 전체 패킷 인디케이션을 가지고 ProtocolReceive 함수를 호출했을 때 TDI 트랜스포트는 인디케이션을 가지고 등록된 ClientEventChainedReceive나 ClientEventChainedReceiveExpedited 핸들러를 호출하지 말아야한다. 대신에 TDI 트랜스포트는 트랜스포트 할당 버퍼안으로 클라이언트를 위해서 인디케이트된 데이타를 복사해야한다. 그리고 ClientEventReceive(Expedited) 핸들러를 호출해야한다. 트랜스포트 스택의 밑에서 ProtocolReceive 함수로의 NDIS 호출은 하부의 NIC 미니포트가 인디케이트되는 리시브 데이타를 복사하거나, 그리고 미니포트가 NIC의 리시브 버퍼공간에서 짧기 때문에 가능한 한 빨리 패킷 디스크립터를 리턴하도록 모든 상위 레벨 네트웍 드라이버에게 기대한다는 것을 암시한다.