NdisMSendComplete

VOID 

  NdisMSendComplete(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN PNDIS_PACKET  Packet,

    IN NDIS_STATUS  Status

    );

NdisMSendComplete 함수는 이전의 NDIS_STATUS_PENDING으로 리턴된 패킷에 대해서 완성된 보내기 요청의 최종 상태와 패킷을 리턴한다.

매개변수

MiniportAdapterHandle
MiniportInitialize 에서 입력된 근본적인 핸들을 서술한다.

Packet
MiniportSend 에서 입력된 프로토콜 할당 패킷을 가리킨다.

Status
완료된 전송 요청의 마지막 상태를 서술한다.

주석

NDIS 라이브러리는 직렬화된 미니포트를 대신해서 보내기 패킷을 큐에 저장한다. 그래서 미니포트는 장치전송 연산을 단번에 처리할 수 있다. (그러나 미니포트는 NIC의 능력에 의존해서 연산당 몇개의 전송을 할 수 있다.) NDIS는 각각의 직렬화된 미니포트의 MiniportSendPackets 함수로 패킷 배열의 제출을 직렬화한다. 그리고 각각의 미니포트의 MiniportSend 함수로 패킷의 제출을 직렬화한다. NDIS는 직렬화된 NIC 드라이버는 이미 바쁜 이유로 각각의 보내기 요청들을 즉시 전해줄 수 없을 때 FIFO에 큐한다.

모든 연결지향 미니포트를 포함하는 비직렬화된 미니포트는 Miniport(Co)Send(Packets) 함수가 호출될 때면 언제든지 모든 보내기 요청들을 받아들임에 있어서 책임을 진다. 만약 필요하다면 비직렬화된 드라이버는 데이타를 보내기위한 충분한 자원을 가질 때까지 보내기 패킷을 큐에 저장한다. 비직렬화된 미니포트는 NdisMSendComplete 함수를 가지고 모든 보내기를 비동기적으로 완성한다.

직렬화된 미니포트의 MiniportSendPackets 함수가 패킷의 OOB 데이타 블럭안의 상태를 NDIS_STATUS_PENDING으로 설정한다면 혹은 MiniportSend 함수가 패킷에 대해서 NDIS_STATUS_PENDING을 리턴한다면 미니포트는 보내기 요청의 완료를 알리기위해 원래 패킷을 가지고 결국 NdisMSendComplete 함수를 호출해야한다. 보내기 패킷의 상태가 pending인 동안에 미니포트는 그 패킷 디스크립터의 소유권과 패킷 디스크립터와 연관된 모든 프로토콜 할당 자원들을 유지한다.

NdisMSendComplete 함수 호출은 NdisCoSendPackets, NdisSendPackets 혹은 NdisSend로의 호출을 가지는 초기화된 드라이버의 ProtocolSendComplete 함수를 NDIS가 호출하도록 한다. 미니포트의 NdisMSendComplete 함수 호출은 주어진 패킷 디스크립터의 소유권과 그들을 할당한 프로토콜 드라이버에 관련된 자원들을 해제한다.

만약 직렬화된 드라이버의 MiniportSend(Packets) 함수가 주어진 패킷에 대해서 NDIS_STATUS_PENDING이 아닌 다른 상태를 리턴한다면 미니포트는 결코 NdisMSendComplete 함수를 호출하지 않는다. MiniportSend(Packets) 함수로부터의 리턴은 패킷의 소유권을 해제한다. 결과적으로 직렬화된 미니포트는 MiniportSend(Packets) 함수가 NDIS_STATUS_PENDING을 리턴하지 않는 어떤 패킷에 대해서 NdisMSendComplete 함수를 호출할 필요가 없다. 직렬화된 NIC 드라이버가 NDIS_STATUS_PENDING이 아닌 무언가를 리턴하는 어떤 보내기 패킷은 MiniportSend(Packets) 함수가 통제를 리턴하자마자 미니포트에 의해서 접근할 수 없음이 고려된다.

미니포트의 NdisMSendComplete 함수 호출은 특정 패킷이 반드시 네트웍 상으로 전송 완료되었음을 의미하지는 않는다. 보통 그러한 패킷은 아마도 패킷이 하드웨어 안에 큐될 수 있는 NIC 드라이버를 제외하고는 전송되어진다.

선행된 OID_GEN_MEDIA_SUPPORTED 혹은 OID_GEN_MEDIA_IN_USE 에 대한 응답으로 장치의 타입을 NdisMediumWan으로 선언한 미니포트 드라이버는 NdisMSendComplete 보다는 오히려 NdisMWanSendComplete 함수를 호출할 것이다.

NdisMSendComplete 함수의 직렬화된 호출자는 IRQL DISPATCH_LEVEL에서 실행되어야한다. NdisMSendComplete 함수의 비직렬화된 호출자는 IRQL <= DISPATCH_LEVEL에서 실행할 수 있다.