NdisCoSendPackets

VOID NdisCoSendPackets( IN NDIS_HANDLE NdisVcHandle, IN PPNDIS_PACKET PacketArray, IN UINT NumberOfPackets );

NdisCoSendPackets함수는 네트웍으로 전송을 위해 멀티패킷보내기를 하위 닉 드라이버로 지정한 VC로 포워드 한다.

매개변수

NdisVcHandle

VC에대한 핸들을 지정한다. 따라서 보내기의 타겟을 확인한다.

PacketArray

호출자 할당 패킷 디스크립터들에대한 포인터 배열의 포인터. 배열내의 각 패킷 디스크립터는 하위 닉 드라이버가 선으로 보내야만 하는 데이타를 포함하는 버퍼를 맵핑하는 체인된 버퍼 디스크립터들을 가지고 있다.

각 패킷 디스크립터들은 또한 연관된 NDIS_PACKET_OOB_DATA블럭을 가지고 있다. 이것은 호출자가 하위 닉 드라이버와 네트웍 미디엄과 관련된 어떤 타임 스탬프 와/혹은 미디엄 지정 OOB정보를 설정할수 있다.

NumberOfPackets

PacketArray에 포인터 수를 지정한다.

주석

NdisCoSendPackets함수의 호출은 NDIS가 닉 드라이버의 MiniportCoSendPackets함수를 호출하도록 한다. NDIS는 패킷 배열을 그들이 NdisCoSendPackets함수에게 넘기는 것처럼 같은 순서로 하위 드라이버의 MiniportCoSendPackets함수에게 넘긴다.

ProtocolCoSendComplete함수가 호출될때 NdisCoSendPackets함수의 호출자는 그런 배열내의 각 패킷 디스크립터들에대해 리턴된 상태를 각각 테스트해야만 한다. NDIS가 보내는 프로토콜에의해 결정되는 FIFO순서내의 전송에대해 항상 제출하는 동안 하위 닉 드라이버는 그런 보내기를 랜덤한 순서로 완료할지 모른다.

프로토콜이 NdisCoSendPackets함수를 호출하자마자, 다음과 같은 소유권을 양도한다.:

• PacketArray에 접근할수 있는 모든 패킷 디스크립터.
• 그러한 패킷 디스크립터들에게 체인된 버퍼 디스크립터들에의해 맵된 모든 버퍼.
• OOB블럭들내의 어떤 미디엄 지정 버퍼들을 포함하는 패킷 디스크립터들과 관계된 모든 OOB데이타 블럭.

그리고나서 ProtocolCoSendComplete함수는 프로토콜이 할당한 이런 리소스들을 해재하거나 재사용을 위해 준비하거나 할수 있다. 평균-상위의 네트웍 I/O트래픽 기간중, 프로토콜이 할당한 패킷 디스크립터들과 버퍼들의 재사용하는것은 버퍼와 패킷 디스크립터를 해제하고 순차적인 보내기에대해 거의 즉시 그들을 재 할당 하는것보다 더 좋은 퍼포먼스를 낳는다. 그러나, 시스템 리소스들의 사용을 조심스럽게 다루는 어떤 프로토콜은 높은 트래픽의 기간이 매우 낮은 I/O요구의 기간을 지속한후에 막연하게 맵된 버프들로 패킷 디스크립터들을 재사용할수 있는 패킷들의 큰 셋을 보유하지 않는다. ProtocolCoSendComplete함수가 패킷 디스크립터들을 재사용할때, NdisUnchainBufferAtXxx함수의 호출로 각 입력 패킷 디스크립터들과 체인된 버퍼 디스크립터들을 저장해야만 한다.(애매) 입력 패킷 디스크립터로 NdisReinitializePacket함수를 호출하기전에.

NdisCoSendPackets함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.