TdiReturnChainedReceives

VOID
   TdiReturnChainedReceives(
       IN PVOID *TsduDescriptors,
       IN ULONG NumberOfTsdus
       );

TdiReturnChainedReceives 함수는 체인화된 각각의 리시브 인디케이션을 위해서 STATUS_PENDING을 리턴한 트랜스포트의 클라이언트로 전에 전달된 하나이상의 것으로 체인화된 리시브 인디케이션에 대해서 TSDU 디스크립터의 배열을 리턴한다.

매개변수

TsduDescriptors

NDIS_PACKET 타입의 디스크립터 배열을 가리킨다.

NumberOfTsdus

TsduDescriptors에 배열에서 묘소의 수를 서술한다.

주석

더 빠른 네트웍의 효율을 위해서 TDI 트랜스포트는 다음의 상황에서 주어지는 리시브된 전체 네트웍 패킷을 포함하는 NDIS 미니포트 할당 버퍼의 체인으로의 접근을 클라이언트에게 전달한다:

• 트랜스포트 스택의 밑에서 NDIS 프로토콜 드라이버가 NdisRegisterProtocol 함수를 가지고 ProtocolReceivePacket 함수를 등록했다. 그래서 하부의 NDIS 미니포트 리시브 버퍼의 내용으로의 읽기전용 접근을 허락하는 인디케이션을 리시브할 수 있다. 트랜스포트가 드라이버의 물리 NIC과 직접 바인딩한다면 ProtocolReceivePacket 함수는 NIC의 리시브 버퍼에 대해서 읽기 전용접근을 얻는다.
• 하부의 NIC 드라이버는 인디케이션을 리시브하기 위해서 NdisMIndicateReceivePacket 함수를 호출한다. 따라서 트랜스포트 스택의 상위에서 TDI 드라이버에 대한 하나이상의 클라이언트에 의해서 수신된 데이타를 소비할 때까지 ProtocolReceivePacket 함수를 제공하는 바인딩된 프로토콜로 하여금 NIC 드라이버의 리시브 버퍼안에 리시브된 데이타로의 읽기전용 접근을 허락한다. 그러한 리시브 인디케이션은 항상 각각의 인디케이트된 NDIS_PACKET 타입의 TSDU 디스크립터에 체인화된 버퍼 디스크립터(MDL)에 의해서 맵된 전체 네트웍 패킷이다.
• 클라이언트는 트랜스포트와 함께 TDI_EVENT_CHAINED_RECEIVE 혹은 TDI_EVENT_RECEIVE_DATAGRAM 이벤트를 위해서 그들의 핸들러를 등록했다.

TdiReturnChainedReceives 함수로의 TDI 클라이언트의 호출은 인디케이트된 패킷 디스크립터와 모든 연관된 자원을 트랜스포트 스택에서 인디케이트하는 TDI 드라이버와 하위 드라이버를 우회하므로써 직접 NDIS에게 리턴한다. 이것은 NDIS로 하여금 NDIS가 같은 NDIS 미니포트와 자신들을 바인딩한 다른 트랜스포트로 이 체인화된 리시브를 인디케이트한 후에 패킷 디스크립터와 연관된 자원을 원래 패킷 디스크립터와 체인화된 버퍼 디스크립터를 할당한 하부의 NDIS 미니포트(혹은 NDIS 인터미디엇 드라이버)로 신속하게 리턴하는 것을 허락한다.

하부의 NDIS 드라이버에 의해서 트랜스포트의 ProtocolReceive 함수로 인디케이트된 패킷은 내부적으로 트랜스포트안에 버퍼화되어야 하지만 그들은 클라이언트의 ClientEventReceive, ClientEventReceiveExpedited, 혹은 ClientEventReceiveDatagram 함수로 인디케이트되어야한다. 이들 클라이언트 이벤트 핸들러로의 호출은 클라이언트에게 가능한 한 빨리 인디케이트된 데이타를 복사하도록 지시한다. 그리고 ClientEventReceive(Expedited/Datagram) 함수는 이벤트 핸들러가 통제를 리턴할 때 인디케이트된 데이타를 포함하는 버퍼로의 클라이언트 접근을 허락한다.

등록된 ClientEventChainedReceive, ClientEventChainedReceiveExpedited, 그리고 ClientEventChainedReceiveDatagram 핸들러를 가지는 커널 모드 클라이언트만이 TdiReturnChainedReceives 함수를 호출한다.

TdiReturnChainedReceives 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.