ProtocolCoSendComplete
VOID
ProtocolCoSendComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE ProtocolVcContext,
IN PNDIS_PACKET Packet
);
|
ProtocolCoSendComplete 함수는 연결 지향 프로토콜 드라이버들에서 필요한 드라이버 함수이다. ProtocolCoSendComplete 함수는 NdisCoSendPackets 에 전에 전달된 프로토콜 초기화 보내기의 처리를 완성한다.
매개변수
- Status
- 아래 드라이버로부터 전달된 에러 상태 혹은 NDIS_STATUS_SUCCESS인 보내기 연산의 마지막 상태를 지정한다.
- ProtocolVcContext
- 프로토콜 드라이버가 VC당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 드라이버는 원래 ProtocolCoCreateVc 함수로부터 혹은 NdisCoCreateVc 함수를 호출할 때 이 핸들을 제공한다. 이 컨텍스트 영역은 드라이버가 전에 NdisCoSendPackets 함수로 전달하는 NdisVcHandle을 포함한다.
- Packet
- 완성된 보내기를 위한 프로토콜 제공 패킷 디스크립터를 가리킨다.
주석
ProtocolCoSendComplete 함수는 VC를 통해 네트워크을 걸쳐 데이터를 보내기 위해 프로토콜에게 요구하는 클라이언트에게 알리는 것과 같은 후처리가 완성된 전송 연산을 필요한 것들을 행한다.
보내기 연산의 완성은 항상 아래 NIC 드라이버가 실제 네트워크을 걸쳐 주어진 패킷을 전송했다는 것을 암시한다. 그러나, 소위 지능형 NIC의 드라이버는 NIC에 네트워크 패킷을 다운로드하자마자 보내기 완성을 고려할 수 있다. NdisMCoSendComplete 함수에 대한 아래 드라이버의 호출은 NDIS에게 ProtocolCoSendComplete 함수를 호출하도록한다.
ProtocolCoSendComplete 함수가 호출될 때, 드라이버는 다음과 같은 프로토콜 할당 자원들의 소유권을 얻는다. :
- Packet인 패킷 디스크립터
- 이러한 디스크립터들에 의해 맵된 어떤 프로토콜 할당 버퍼들과 네트워크 패킷을 포함하는 버퍼들을 맵한 패킷 디스크립터에 체인화된 모든 버퍼 디스크립터들.
- 패킷 디스크립터와 관련된 어떤 대역외 블럭
- MediaSpecificInformation인 대역외 블럭내에 지정된 어떤 프로토콜 할당 버퍼
결과적으로, ProtocolCoSendComplete 함수는 NdisCoSendPackets 함수에 대한 연속적인 호출로 재사용을 위해 이러한 자원들을 해제할 수 있거나 그들을 준비할 수 있다. 일반적인 규칙으로, 그러한 자원들을 재 사용하는 것은 만약 프로토콜이 전에 많은 I/O 요구 시기에 다르는 이러한 자원들의 초과분을 할당한다면 낮은 네트워크 트래픽 시기를 제외해 그들을 해제하는 것보다 더 좋은 퍼포먼스를 낳는다.
재사용을 위해 버퍼와 패킷 디스크립터들을 준비하기 위해, ProtocolCoSendComplete 함수는 이러한 가이드라인들을 따라야 한다. :
- 항상 ProtocolCoSendComplete 함수는 Packet인 디스크립터로 NdisReinitializePacket 함수를 호출하기 전에 버퍼 디스크립터 포인터들을 저장하는데 필요한 만큼 NdisUnchainBufferAtXxx 함수를 호출한다.
그렇지 않으면, NdisReinitializePacket 함수는 버퍼 체인의 헤드를 NULL로 설정해서 프로토콜은 패킷 디스크립터에 체인화된 버퍼 디스크립터들에 대한 포인터를 회복할 수 없게 한다. 프로토콜은 클라이언트 제공 버퍼들에 맵핑된 MDL들을 잃거나 프로토콜이 NdisAllocateBuffer 함수로 할당한 버퍼 디스크립터들을 잃는다.
- 항상 Packet 포인터가 아닌 관련된 대역외 블럭을 클리어하기 위해 NdisZeroMemory 함수로 NDIS_OOB_DATA_FROM_PACKET 에 의해 리턴된 포인터를 전달한다.
그렇지 않으면, NdisZeroMemory 함수는 연속적인 보내기들을 지정하기 위해 사용할 수 없게 하는 프로토콜이 NdisAllocatePacket 함수로 할당된 패킷 디스크립터를 파괴한다.
대역외 블럭을 지우기 위한 대체로, 프로토콜은 프로토콜이 정상적으로 적당한 NDIS_SET_PACKET_XXX 매크로들로 보내기들이 설정하는 이러한 멤버들을 재초기화할 수 있다.
ProtocolCoSendComplete 함수가 호출될 때까지, 프로토콜 초기화된 보내기의 현 상태는 volatile하다. 프로토콜은 일시적으로 만약 프로토콜이 보내기들을 위해 할당한 패킷 디스크립터들로 대역외 정보를 제공한다면 NdisCoSendPackets 함수를 호출할 때 보내기를 위한 할당한 모든 자원들의 소유권들을 해제한다. 특히, 프로토콜은 결코 NdisCoSendPackets 함수가 제어를 리턴할 때 관련된 대역외 데이터 블럭의 Status 멤버를 조사하는 시도를 결코 할 필요가 없다.
비록 NDIS는 항상 NdisCoSendPackets 함수에 대한 호출에서 전달된 프로토콜 결정 순서로 아래 미니포트로 프로토콜 제공 패킷 배열을 제출한다. 즉, 모든 바인드된 프로토콜은 아래 드라이버에 FIFO 순서로 프로토콜이 NdisCoSendPackets 함수로 전달하는 패킷들을 제출하는 것을 NDIS에 의존하지만, 프로토콜은 같은 순서로 이러한 패킷들로 NdisMCoSendComplete 함수를 호출하는 아래 드라이버에 의존할 수 없다.
ProtocolCoSendComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|