NdisReturnPackets

VOID

  NdisReturnPackets(

    IN PNDIS_PACKET  *PacketsToReturn,

    IN UINT  NumberOfPackets

    );

NdisReturnPackets은 프로토콜이 리시브 데이터를 소비한 후에 하나나 그 이상의 패킷에 대한 소유권을 양도한다.

매개변수

PacketsToReturn
리시브 인디케이션을 위해 할당된 패킷 디스크립터가 아래단의 드라이버에게 리턴받기 위한 포인터의 배열을 가리킨다.

NumberOfPackets
배열안 포인터들의 수를 명시한다.

주석

인터미디엇 드라이버는 Protocol(Co)ReceivePacket가 제어권을 리턴하자 마자 곧 NdisReturnPackets 함수를 호출해야 한다. 다시 말해서, 멀티패킷 리시브 인디케이션을 지원하는 아래단의 드라이버와 그것들을 처리하는 프로토콜 드라이버 둘 다 성능의 하락을 가진다.

아래단의 NIC 드라이버가 리시브 인디케이션을 위해 가능한 패킷 풀에서 낮게 실행될 때나 그 NIC이 비어있는 리시브 버퍼에서 낮게 실행될때, 이것은 패킷 디스크립터의 연결된 OOB 블럭 상태를 NDIS_STATUS_RESOURCES로 셋한다:

  • 만약 아래단 NIC 드라이보가 비연결 지향 드라이버라면, 이것은 NDIS 라이브러리가 미니포트가 이 패킷 디스크립터의 소유권을 되찾고 NIC이 들어오는 net 패킷을 버퍼에 받을 수 있을 때 까지 모든 바인드된 프로토콜 드라이버의 한 타임의 싱글 패킷의 ProtocolReceive 함수를 호출하도록 강요한다.

  • 만약 아래단 NIC 드라이버가 연결 지향 드라이버라면, 이것은 NDIS 리이브러리가 미니포트가 이 패킷 디스크립터의 소유권을 되찾고 NIC이 들어오는 net 패킷을 버퍼에 받을 수 있을 때 까지 모든 바인드된 프로토콜 드라이버의 ProtocolCoReceivePacket 함수를 호출하도록 강요한다.

ProtocolReceive 함수는 ProtocolReceiveComplete 함수가 호출될때 까지 받은 데이터의 패킷의 postprocessing을 할 수 없고 클라이언트에게로 처리된 데이터의 포워드 할수 없다.

패킷 디스크립터가 NDIS_STATUS_SUCCESS의 연결된 OOB 상태와 함께 비연결지향 프로토콜의 ProtocolReceivePacket 함수나 연결지향 프로토콜의 ProtocolCoReceivePacket 함수를 패스하기위해, 상윌벨 프로토콜 드라이버는 리시브 데이터의 복사와 클라이언트로 처리된 데이터의 포워드를 처리할 수 있다.왜냐하면 프로토콜은 얼마나 오래 인디케이팅 드라이버에의해 할당된 리소스가 남아 있는지 제어할 수 있다. 제일 높은 레벨 프로토콜 드라이버는 클라이언트에게 인디케이트하는 데이타에대한 메시지를 하지 않는다. 프로토콜은 클라이언트에게 관심있는 리시브 버퍼 사이의 데이터의 범위를 균등하게 셋업 할 수 있다. 그리고 들어온 패킷 디스크립터를 클라이언트들로 포워딩 함으로써 클라이언트로의 리시브 인디케이션을 만든다.

만약 인터미디엇 프로토콜 드라이버의 Protocol(Co)ReceivePacket 함수가 들어온 패킷 디스크립터를 위해 0이아닌 참조 값을 리턴한다면, 드라이버는 한번이나 그이상 NdisReturnPackets 함수를 호출해야 한다. Protocol(Co)ReceivePacket로 부터 개별적인 패킷 디스크립터와 함께 아주 여러번 NdisReturnPackets 함수가 호출됬을때, NDIS 라이브러리는 드라이버가 인디케이션을 만들게 패킷디스크립너를 리턴한다. 들어온 패킷 디스크립터를 클라이언트에게 포워드하는 최상위 레벨 프로토콜을 위해 클라이언트들은 TdiReturnChainedReceives함수의 호출을 만드는것에의해 할당된 NDIS 드라이버에게 패킷 디스크립터를 리턴한다.

프로토콜 드라이버는 Protocol(Co)ReceivePacket 함수에 전달되는 모든 수신 패킷을 위한 참조 카운트를 관리하기 위해 NDIS에게 의존할 수 있다. 패킷 디스크립터를 위한 참조 카운트는 원래 Protocol(Co)ReceivePacket으로부터 리턴값을 0으로 설정할 때, NDIS 라이브러리는 해제된 패킷 디스크립터로 인디케이트되는 드라이버의 MiniportReturnPacket 함수를 호출한다.

NdisReturnPackets 함수는 Protocol(Co)ReceivePacket 함수로부터 호출될 수 없다.

NdisReturnPackets 함수의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행한다.