NdisSendPackets

VOID NdisSendPackets( IN NDIS_HANDLE NdisBindingHandle, IN PPNDIS_PACKET PacketArray, IN UINT NumberOfPackets );

NdisSendPackets 함수는 하부의 드라이버로 가능하다면 OOB 정보와 연관된 다중패킷 보내기 리퀘스트를 알린다.

매개변수

NdisBindingHandle

타겟 NIC을 확인하거나 호출자가 바인딩한 다음 하위 드라이버의 가상 어댑터를 확인하는 NdisOpenAdapter 함수에 의해서 리턴된 핸들을 서술한다. 하부의 드라이버가 연결지향 미니포트라면 프로토콜은 NdisSend 함수보다는 NdisCoSendPackets 함수를 호출해야한다.

PacketArray

패킷 디스크립터에 대한 포인터의 배열을 가리킨다. 배열안에 각각의 패킷 디스크립터는 하부의 NIC 드라이버가 네트웍 상으로 전송해야하는 데이타를 포함하는 버퍼를 매핑한 체인화된 버퍼 디스크립터를 갖는다. 또한 각각의 패킷 디스크립터는 연관된 NDIS_PACKET_OOB_DATA 블럭을 갖는다. 호출자는 하부의 드라이버와 연관된 패킷 우선권과 같은 미디엄 특정 OOB 정보와 타임스탬프를 이미 설정했다.

NumberOfPackets

패킷 배열안에 포인터를 서술한다.

주석

주어진 배열에 각각의 요소는 NDIS_PACKET 타입의 디스크립터에 대한 포인터이다. 그리고 각각의 패킷 디스크립터는 연관된 NDIS_PACKET_OOB_DATA 블럭안에 호출자 설정 TimeToSend와 MediaSpecificInformation 그리고 MediaSpecificSize 값들을 가질 수 있다. 호출자는 NdisAllocatePacket 함수를 갖고 각각의 그러한 패킷 디스크립터를 할당해야한다.

프로토콜은 NdisSendPackets 함수를 호출하기 전에 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO를 가지고 보내기 리퀘스트를 수행하는 OOB 정보를 설정할 수 있고 NDIS_SET_PACKET_TIME_TO_SEND를 가지고 이 타임스탬프를 설정할 수 있다. 하부의 드라이버는 이와는 반대로 NDIS_GET_PACKET_XXX 매크로를 가지고 이 정보들을 얻을 수 있다.

필요하다면 프로토콜은 하부의 드라이버를 위해서 정보를 가지고 패킷 디스크립터의 플래그를 설정하기 위해서 NdisSetPacketFlags 함수를 호출할 수 있다.

만약 하부의 드라이버가 MiniportSendPackets 핸들러를 익스포트하지 않는다면 NDIS 라이브러리는 드라이버의 MiniportSend 함수로 제공된 패킷 배열의 각각의 패킷을 위해서 하나의 호출을 순서적으로 한다. NDIS는 패킷이 제공된 배열에 도착했을 때 같은 순서로 하부 드라이버의 MiniportSend 함수로 각각의 패킷을 전달한다.

NDIS는 패킷이 NdisSendPackets 함수로 전달됐을 때 같은 순서로 하부 드라이버의 MiniportSendPackets 함수로 패킷 배열을 제출한다. 하지만 하부의 직렬화된 미니포트는 하나의 배열 요소를 위해서 OOB 데이타 블럭안에 NDIS_STATUS_RESOURCES를 설정하므로써 NDIS로 들어오는 배열안으로 패킷의 모음을 리턴할 수 있다. 이럴 때 NDIS는 나중에 MiniportSendPackets 함수로의 재제출을 위해서 배열안에 패킷을 큐에 저장한다.

직렬화된 미니포트에서 NDIS는 항상 NdisSend나 NdisSendPackets 함수호출로 전달되든 안되든 프로토콜 결정 보내기 패킷의 순서를 지킨다. 그리고 FIFO 순서로 하부의 드라이버로 넘어갔는지를 확인한다. 프로토콜 드라이버가 패킷 디스크립터 포인터의 배열을 가지고 NdisSendPackets 함수를 호출하기 전에 프로토콜은 패킷이 네트웍 상으로 보내졌을 때 같은 순서로 포인터의 배열이 설정됐는지를 확실히 해야한다.

NdisSendPackets 함수의 호출자는 ProtocolSendComplete 함수가 완료상태를 가지고 호출됐을 때 그러한 배열의 각각의 패킷에 대해서 리턴된 상태를 테스트해야한다. NDIS가 프로토콜 전송에 의해서 결정된 FIFO 순서로 전송을 위한 패킷을 제출하는 동안에 하부의 드라이버는 닥치는 대로 그러한 보내기들을 완료한다.

하부의 드라이버가 비직렬화된 미니포트라면 들어오는 모든 보내기 패킷을 받아들여야하고 필요하다면 그들을 내부적으로 큐에 저장해야한다. 비직렬화된 미니포트는 패킷 디스크립터들이 내부큐에 저장되는 동안에 바인딩된 프로토콜이 NdisSendPackets 함수로 제출하는 프로토콜 결정 순서를 갖는 패킷 디스크립터를 유지해야한다. 항상 비직렬화된 드라이버는 보내기를 비동기적으로 완료한다. 결과적으로 비직렬화된 미니포트와 바인딩된 프로토콜은 그들의 ProtocolSendComplete 함수로 전달되는 Status 값을 리퀘스트된 보내기의 마지막 상태 값으로 설정해야한다.

프로토콜은 NdisSendPackets 함수를 호출하자마자 다음의 소유권을 양도한다:

• PacketArray에 모든 패킷 디스크립터
• 그러한 패킷 디스크립터에 체인화된 버퍼 디스크립터에 의해서 맵된 모든 버퍼들
• OOB 데이타 블럭안에 명시된 미디엄 특정 버퍼를 포함하는 패킷 디스크립터와 연관된 모든 OOB 데이타 블럭

패킷 디스크립터가 ProtocolSendComplete 함수로 리턴될 때 NdisUnchainBufferAtXxx 함수로의 호출을 가지고 패킷 디스크립터에 체인화된 버퍼 디스크립터를 저장한 후에 재사용을 위해서 패킷을 준비하는 NdisReinitializePacket 함수를 호출할 수 있다. 그러한 패킷 디스크립터를 재사용하는 것은 NdisFreePacket 함수를 가지고 드라이버 할당 패킷 풀에 대한 디스크립터를 리턴하고 나중에 또다른 보내기를 위해서 자원을 재할당하는 것보다 더 좋은 퍼포먼스를 얻는다.

ProtocolSendComplete 함수는 또한 재사용을 위해서 프로토콜이 어떤 OOB 정보를 제공한다면 주어진 패킷 디스크립터와 연관된 OOB 블럭을 준비할 수 있다. 선택적으로 프로토콜은 순차적인 보내기를 위해서 패킷 디스크립터가 설정됐을 때 사용하는 멤버들을 확실하게 재초기화할 수 있다.

NDIS 인터미디엇 드라이버는 NdisSendPackets (혹은 NdisSend) 함수를 갖는 하부의 미니포트로 그러한 보내기 리퀘스트를 전달하기 전에 신선한 패킷 디스크립터안에 더 높은 레벨의 프로토콜로부터 각각의 들어오는 보내기들을 재패키지화해야한다.

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