ProtocolSendComplete

VOID

  ProtocolSendComplete(

      IN NDIS_HANDLE  ProtocolBindingContext,

      IN PNDIS_PACKET  Packet,

      IN NDIS_STATUS Status

      );

ProtocolSendComplete함수는 NDIS_STATUS_PENDING을 리턴한 NdisSend혹은 NdisSendPackets에게넘겨준 이전의 프로토콜이 시작한 보내기의 연산을 완료하는 필수적인 드라이버함수이다.

NdisSendPackets함수(NdisSend함수)가 아닌 NdisCoSendPackets를 호출하는 연결지향 프로토콜은 ProtocolSendComplete함수보다는 fully functional ProtocolCoSendComplete함수를 가져야만한다.

매개변수

ProtocolBindingContext
프로토콜드라이버가 바인딩루틴당 상태를 유지하는 프로토콜할당 컨텍스트영역의 핸들을 지정한다. 드라이버는 NdisOpenAdapter함수를 호출할때 이핸들을 제공한다.

Packet
완료된보내기에대한 프로토콜제공 패킷디스크립터의 포인터

Status
보내기연산의 최종상태를 지정한다.

주석

ProtocolSendComplete함수는 완료된 전송연산에대해 차후연산이 필요한것을 수행한다. 네트웍상으로 데이타를 보내라고 프로토콜에게 요청한 클라이언트에게 알리는 것과 같은 것.

보내기연산의 종료는 일반적으로 하위닉드라이버가 실제로 주어진 패킷을 네트웍사으로 보낸것을 암시한다. 그러나, 소위 인텔리젼트한 NIC의 드라이버는 넷팻킷을 닉으로 보내자마자 보내기완료로 간주한다. 하위드라이버의 NdisMSendComplete 혹은 NdisMWanSendComplete함수의 호출은 NDIS로 하여금 ProtocolSendComplete함수의 호출을 야기시킨다.

ProtocolSendComplete함수가 호출됐을때, 드라이버는 다음과 같은 프로토콜 할당 리소스들의 소유권을 다시 얻는다:

  • 패킷의 패킷디스크립터

  • 넷패킷데이타를 포함하는 버퍼를 맵하는 패킷디스크립터에 체인된 버퍼디스크립터와 이런 디스크립터에 의해 맵된 프로토콜 할당 버퍼들

  • 패킷디스크립터와 관계된 OOB블럭

  • OOB블럭의 MediaSpecificInformation에 지정된 프로토콜할당 버퍼

결과적으로, ProtocolSendComplete함수는 이런리소스들을 해제하거나 혹은 NdisSendPackets 혹은 NdisSend 의 차후호출에서의 재상용을 위해 리소스들을 준비한다. 일반적인 룰로써, 그런 리소스들의 재사용은 프로토콜이 전에 할당한 높은 I/O요구를 다루기위해 리소스들의 잉여분을 할당할때 낮은 네트웍 트래픽시기에서를 제외하고 해제하는것보다 더좋은 퍼포먼스를 보인다.

재사용을 위한 버퍼와 패킷디스크립터의 준비를 위해,ProtocolSendComplete함수는 다음과 같은 내용을 따라야 한다:

  • ProtocolSendComplete함수가 패킷의 디스크립터로 NdisReinitializePacket함수를 호출하기전에 버퍼디스크립터포인터들을 저장할 필요가 있을때마다 항상 NdisUnchainBufferAtXxx함수를 호출한다.

    그렇지 않으면, NdisReinitializePacket함수는 버퍼의 헤드를 널로 설정하여 프로토콜은 패킷디스크립터와 체인된 버퍼디스크립터들의 포인터들을 회복 할 수 없다. 프로토콜이 클라이언트가 제공한 버퍼를 맵핑하는 MDL(S)을 읽어버리거나 프로토콜이 NdisAllocateBuffer로 할당한 버퍼디스크립터의 설정을 읽어버린다.

  • NDIS_OOB_DATA_FROM_PACKET의해 리턴된 포인터를 관련된OOB데이타 블럭을 클리어하기위해 NdisZeroMemory함수에게 넘긴다.패킷포인터가 아니고. NDIS_OOB_DATA_FROM_PACKET은 프로토콜이 NdisAllocatePacket함수로 할당한 패킷디스크립터를 제거한다. 지정된 다음 보내기에대해 사용할수 없게 만들면서.

    OOB블럭의 클리어에대한 양자택일로서, 프로토콜은 프로토콜이 일반적으로 적절한NDIS_SET_PACKET_XXX메크로로 보내기에 대한 설정을 했을때의 멤버들만을 재초기화할 수 있다.

ProtocolSendComplete함수가 호출될때까지, 프로토콜이시작한 보내기의 현재상태는 일시적이다. 프로토콜은 temporarily하게 NdisSendPackets 혹은 NdisSend함수를 호출할때 프로토콜이 보내기에 대해서 할당한 모든 리소스들의 소유권을 해제한다. 비록 프로토콜이 보내기에대해 할당한 패킷디스크립터로 OOB정보를 제공하더라도.

비록 NDIS는 항상 프로토콜제공 패킷배열을 하위 미니포트에게 프로토콜이 결정한 순서로 NdisSendPackets의호출로 제공하지만, 하위드라이버는 주어진 패킷을 랜덤순서로 완료할 수 있다. 즉, 모든 바인딩된 프로토콜은 프로토콜이 FIFO순서로 NdisSendPackets 혹은 NdisSend함수로 넘기는 패킷을 제공하기위해 NDIS에게 의존한다. 그러나 프로토콜이 같은 순서로 그러한 패킷을 가지고 NdisMSendComplete함수를 호출하는 하위드라이버에 의존할 수 없다.

디폴트로, ProtocolSendComplete함수는 자유재량의 스레드 컨텍스트(in an arbitrary thread context)내에서 DISPATCH_LEVEL 에서 동작한다.