ProtocolTransferDataComplete

VOID ProtocolTransferDataComplete( IN NDIS_HANDLE ProtocolBindingContext, IN PNDIS_PACKET Packet, IN NDIS_STATUS Status, IN UINT BytesTransferred );

ProtocolTransferDataComplete 함수는 만약 프로토콜이 NdisMIndicateReceivePacket 함수로 full-packet 수신들을 인디케이트하지 않는 아래 비연결지향 NIC 드라이버와 그 자체가 바인드된다면 필요한 드라이버 함수이다. ProtocolTransferDataComplete 함수는 NdisTransferData 함수가 NDIS_STATUS_PENDING을 리턴하기 위한 프로토콜 초기화된 전송 데이터 요구의 처리를 완성한다.

배타적으로(exclusively) 연결 지향 프로토콜들은 어떠한 ProtocolTransferDataComplete 함수를 호출할 필요가 없다.

매개변수

ProtocolBindingContext

프로토콜 드라이버가 바인당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 드라이버는 NdisOpenAdapter 함수를 호출할 때 이러한 핸들을 제공한다.

Packet

드라이버는 원래 NdisTransferData로 전달하는 프로토콜 할당 패킷 디스크립터를 가리킨다.

Status

전송 데이터 연산의 마지막 상태를 지정한다.

BytesTransferred

NIC 드라이버가 Packet인 패킷 디스크립터에 체인화된 버퍼 디스크립터들에 의해 맵된 버퍼들로 전송하는 데이터의 바이트 수를 지정한다. 프로토콜은 이러한 값을 사용하여 미니포트가 원래 인디케이트된 네트워크 패킷을 위한 요구된 데이터를 제공할 것인지를 결정한다.

주석

ProtocolTransferDataComplete 함수는 NdisTransferData 함수가 제어를 리턴하기 전에 호출될 수 있다. 만약 이것이 발생한다면, 프로토콜 드라이버는 NdisTransferData 함수가 Status를 리턴하는 상태 코드를 조사하기 위한 기회가 없다. 프로토콜은 Packet으로 주어진 패킷 디스크립터는 ProtocolTransferDataComplete 함수가 호출될 때까지 지연된다는 것을 추측해야 한다.

아래 NIC 드라이버는 NdisTransferDataComplete 함수를 호출할 때, NDIS는 ProtocolTransferDataComplete 함수에 대한 미니포트 제공 Packet 포인터와 Status 값을 포워드한다. 이것이 일어날 때, 프로토콜은 NdisTransferData 함수에 대한 선행 호출을 위해 할당한 자원들의 소유권을 다시 얻는다. ProtocolTransferDataComplete 함수가 프로토콜이 ProtocolReceive 함수가 응답하는 인디케이션에서 복사한 데이터로 Packet인 패킷 디스크립터에 대해 체인화한 버퍼들내에 미니포트 할당 데이터를 후처리할 수 있다. 그리고나서 ProtocolTransferDataComplete 함수는 수신된 네트워크 데이터의 관심있는 클라이언트들을 주지할 수 있다.

ProtocolTransferDataComplete 함수는 또한 프로토콜이 NdisTransferData 함수에 대한 호출로 할당한 자원들을 해제할 수 있고 NdisTransferData 함수에 대한 계속적인 호출에서 재사용을 위한 패킷 디스크립터들과 리턴된 버퍼를 준비할 수 있다. 일반적인 규칙에서, 그러한 자원들을 재사용하는 것은 만약 프로토콜이 전에 높은 I/O요구의 시기에 처리하기 위해 추가적인 이러한 자원들을 할당한다면 낮은 네트워크 트래픽 시기에 가능한 제외해 그들을 해제하는 것보다 더 좋은 퍼포먼스를 낳는다.

재사용을 위해 버퍼와 패킷 디스크립터들을 준비하기 위해, ProtocolTransferDataComplete 함수는 이러한 가이드라인들을 따라야 한다.

• 항상 ProtocolTransferDataComplete 함수는 Packet에서 디스크립터로 NdisReinitializePacket 함수를 호출하기 전에 버퍼 디스크립터 포인터들을 저장하기 위해 필요한 만큼 NdisUnchainBufferAtXxx 함수를 호출한다.

  그렇지 않으면, NdisReinitializePacket 함수는 프로토콜이 패킷 디스크립터에 체인화된 버퍼 디스크립터들에 대한 포인터들을 회복할 수 없게 하기 위해 NULL로 버퍼의 헤드 체인을 설정한다. 효율적으로, 프로토콜은 프로토콜이 NdisAllocateBuffer 함수로 할당한 버퍼 디스크립터들의 집합을 읽고 가능한 마찬가지로 이러한 디스크립터들에 의해 맵된 프로토콜 할당 버퍼들에 대한 접근을 잃는다.

• 패킷 디스크립터에 대한 포인터로 NdisZeroMemory 함수를 결코 호출하지 않는다. 그 대신에 NdisReinitialize 함수를 사용하라.

  그렇지 않으면, NdisZeroMemory 함수는 연속적인 데이터 전송들과 보내기들을 지정하기 위해 그것을 사용할 수 없게 만들면서 NdisAllocatePacket 함수로 할당하는 패킷 디스크립터를 파괴한다.