NdisSend

VOID

  NdisSend(

    OUT PNDIS_STATUS  Status,

    IN NDIS_HANDLE  NdisBindingHandle,

    IN PNDIS_PACKET  Packet

    );

NdisSend 함수는 하부의 드라이버에게 보내기 리퀘스트를 알린다.

매개변수

Status
이 함수의 리턴에서 설정된 호출자 제공 변수를 가리킨다. 하부의 드라이버는 어떤 NDIS_STATUS_XXX가 리턴되는지를 결정하지만 보통 다음 값중에 하나이다:

NDIS_STATUS_SUCCESS
주어진 패킷이 네트웍 상으로 전송되고 있다.

NDIS_STATUS_PENDING
리퀘스트가 비동기적으로 처리되고 있다. 그리고 호출자의 ProtocolSendComplete 함수는 그것이 완료될 때 호출된다.

NDIS_STATUS_INVALID_PACKET
리퀘스트된 전송의 사이즈가 NIC에게 너무 크다거나 NIC이 드라이버로 잘못된 패킷 전송을 알렸다.

NDIS_STATUS_CLOSING
하부의 드라이버가 닫힌다.

NDIS_STATUS_RESET_IN_PROGRESS
하부의 드라이버가 NIC을 현재 리셋하고 있는 중이다. 호출자의 ProtocolStatus 함수는 리셋이 진행중임을 알리기 위해서 NDIS_STATUS_RESET_START를 가지고 호출된다.

NDIS_STATUS_FAILURE
이 값은 보통 비특정 기본값이다. 하부의 드라이버가 리퀘스트 실패에 대한 특정 NDIS_STATUS_XXX가 없을 때 리턴된다.

전송연산 동안에 발생되는 장치 I/O 에러에 대해서 리턴된 특정 NDIS_STATUS_XXX는 NIC의 특징과 NIC 드라이버 개발자의 결정에 의존한다. 예를들어 미니포트는 NIC이 이 상태를 드라이버로 알린다면 NDIS_STATUS_NO_CABLE을 리턴한다.

NdisBindingHandle
타겟 NIC을 확인하거나 호출자가 바인딩한 다음 하위 드라이버의 가상 어댑터를 확인하는NdisOpenAdapter 함수에 의해서 리턴된 핸들을 서술한다. 만약 하부의 드라이버가 연결지향 미니포트라면 프로토콜은 NdisSend 함수보다는 NdisCoSendPackets 함수를 호출해야한다.

Packet
하부의 NIC 드라이버가 네트웍 상으로 전송해야하는 데이타를 포함하는 버퍼를 매핑한 체인화된 버퍼 디스크립터를 가지고 NdisAllocatePacket 함수로 할당된 호출자 제공 패킷 디스크립터를 가리킨다.

주석

NdisSend 함수를 호출하기 전에 프로토콜 드라이버는 프로토콜이 할당한 패킷 디스크립터의 프라이빗 헤더(NDIS에 의한 사용을 위해서 예약됨)에 플래그를 설정하기 위해서 NdisSetPacketFlags 함수를 호출할 수 있다. 이 플래그들은 패킷 데이타에 포함되지 않는 리퀘스트된 보내기 연산에 대해서 호출자 결정 정보를 서술한다. 하부 NIC 드라이버의 MiniportSend 함수는 입력 매개변수로써 보내기 플래그를 얻는다. 패킷 플래그 비트의 의미는 미디엄 특정이고 협력하는 드라이버의 쌍에 의해서 정의된다.

그러나 그러한 협력하는 드라이버의 쌍은 패킷 플래그가 전달할 수 있는 것보다 더 많은 정보와 통신하기 위해서 각가의 패킷 디스크립터와 연관된 NDIS_PACKET_OOB_DATA 블럭을 사용할 수 있다. NdisSend 함수를 호출하기 전에 프로토콜은 OOB 정보를 설정하기 위해서 NDIS_SET_PACKET_TIME_TO_SEND와 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO 매크로를 사용할 수 있다. 그것은 프로토콜 할당 패킷 디스크립터와 연관된 NDIS_PACKET_OOB_DATA 블럭안에 하부의 드라이버와 관계가 있다.

직렬화된 하부의 드라이버가 유효한 보내기 패킷을 전송하기 위해서 자원이 부족할 때 다음중 하나를 할 수 있다:

  1. MiniportSend 함수는 내부큐에 패킷을 삽입할 수 있고 NDIS_STATUS_PENDING을 리턴한다.

    자원이 사용될 수 있을 때까지 드라이버는 큐에 저장된 패킷을 유지하고 유사시에 패킷을 보낸다.

  2. MiniportSend 함수는 단지 NDIS_STATUS_RESOURCES를 가지고 통제를 리턴할 수 있다.

    NDIS 라이브러리는 직렬화된 미니포트로 다시 제출하기 위해서 내부큐안에 그러한 리턴된 패킷을 유지한다. 미니포트는 NdisMSendResourcesAvailable 함수나 NdisMSendComplete 함수를 호출하므로써 나중에 보내기 패킷을 받아들일 준비가 됐음을 알릴 수 있다.

NdisSend 함수는 호출자에게 NDIS_STATUS_PENDING을 리턴한다. 그리고 드라이버의 ProtocolSendComplete 함수는 패킷 전송이 완료됐을 때 호출된다. 하부의 드라이버가 비직렬화된다면 NdisSend 함수의 호출로 전달된 모든 패킷은 하부의 비직렬화된 미니포트가 보내기 연산을 완료했을 때 호출자의 ProtocolSendComplete 함수로 리턴된다.

프로토콜이 NdisSend 함수를 호출하자마자 프로토콜은 패킷에 체인화된 버퍼 디스크립터에 의해서 맵된 모든 버퍼의 Packet에 대한 패킷 디스크립터의 소유권을 양도한다. 그리고 패킷 디스크립터를 가지고 제공된 어떤 OOB 정보의 Packet에 대한 패킷 디스크립터의 소유권을 양도한다. 프로토콜은 패킷이 NDIS_STATUS_PENDING 이외의 다른 상태를 가지고 완료됐을 때 그리고 ProtocolSendComplete 함수가 호출됐을 때 이 자원들의 소유권을 다시 얻는다,

이런 일이 발생되면 프로토콜은 NdisUnchainBufferAtXxx 함수 호출로 패킷 디스크립터에 체인화된 버퍼 디스크립터를 저장한 후에 재사용을 위한 패킷을 준비하기 위해서 NdisReinitializePacket 함수를 호출할 수 있다. 그러한 패킷 디스크립터를 재사용하는 것은 NdisFreePacket 함수를 가지고 드라이버 할당 패킷 풀로 패킷을 리턴하고 나중에 또다른 보내기를 위해서 재할당하는 것보다 더 좋은 퍼포먼스를 낳는다.

NDIS 인터미디엇 드라이버는 NdisSend (혹은 NdisSendPackets) 함수를 가진 하부의 미니포트로 그러한 보내기 패킷을 전달하기 전에 신선한 패킷 디스크립터안으로 상위 레벨 프로토콜로부터 들어오는 보내기를 다시 패키지화 해야한다.

NdisSend 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.