NdisMCoSendComplete

VOID NdisMCoSendComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisVcHandle, IN PNDIS_PACKET Packet );

NdisMCoSendComplete는 보내기를 요구한 프로토콜에 대한 관련된 자원들과 패킷 디스크립터를 리턴한다.

매개변수

Status

NDIS_STATUS_PENDING을 제외한 NDIS_STATUS_SUCCESS 혹은 어떤 드라이버 결정 NDIS_STATUS_XXX로 보내기 연산의 상태를 지정한다.

NdisVcHandle

주어진 패킷 데이터가 보내어지는 VC에 대한 핸들을 지정한다. 미니포트는 최근 MiniportCoSendPackets 함수에 입력 매개변수로 전달되어지는 MiniportVcContext로부터 이 핸들을 얻는다.

Packet

보내어지는 버퍼화된 프로토콜 제공 데이터를 맵핑하는 연결된 버퍼 디스크럽터들로 패킷 디스크립터를 가리킨다.

주석

NDIS는 어떤 연결 지향 NIC 드라이버가 비직렬화된 미니포트라고 가정한다; 즉, NDIS는 MiniportCoSendPackets 함수를 가지는 드라이버를 위해 들어오는 보내기들을 직렬화하거나 큐로 저장하지 않는다.

그러한 연결 지향 NIC 드라이버는 NDIS가 보내기 연산을 초기화하는 할당한 프로토콜에 대한 관련된 자원들과 패킷 디스크럽터들을 리턴함으로써, 결과적으로 MiniportCoSendPackets을 포워드하는 각 패킷 디스크립터로 NdisMCoSendComplete를 호출해야 한다. NdisMCoSendComplete에 대한 미니포트의 호출은 반드시 패킷 디스크립터와 관련된 모든 데이터가 목적지에 네트워크 가로질러 전송되어진다는 것을 의미하지는 않는다. 가능하다면은 MiniportCoSendPackets 함수는 실제 프로토콜 제공 데이터를 NIC의 전송 버퍼들로 복사한 후 각 입력 보내기 패킷을 NdisMCoSendComplete로 완성하거나 혹은 아마 미니포트는 패킷 데이터가 NdisMCoSendComplete 를 호출하기 전에 네트워크 가로질러 전송되어질 때까지 내부 큐에 보내기 패킷들을 유지한다.

만약 NdisVcHandle에 의해 지정된 VC는 CO_MEDIA_PARAMETERS 구조체의 Flags 멤버내에 INDICATE_END_OF_TX로 설정해서 NIC 드라이버의 MiniportCoActivateVc 함수에 의해 활성화되어진다면은, 미니포트는 패킷 데이터의 전송이 실제 완성될 때까지 NdisMCoSendComplete를 호출할 수 없다.

어떤 경우에는, NdisMCoSendComplete에 대한 호출은 NDIS가 원래 Packet에 패킷 디스크립터로 NdisCoSendPackets을 호출하는 드라이버의 ProtocolCoSendComplete 함수를 호출하도록 한다.

NdisMCoSendComplete로, 미니포트는 주어진 패킷 디스크립터와 원래 이러한 자원들을 할당한 프로토콜에 대해 그것과 관련된 모든 자원들의 소유권을 회복한다. NIC 드라이버는 더 이상 패킷 디스크립터, 패킷 디스크립터에 연결된 버퍼 디스크립터들 혹은 그들이 맵한 버퍼들, NdisMCoSendComplete를 호출한 후 패킷 디스크립터와 관련된 아웃 오브 밴드 데이터 블럭에 접근할 수 없다.

NdisMCoSendComplete의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행될 수 있다.