MiniportSendPackets

VOID MiniportSendPackets( IN NDIS_HANDLE MiniportAdapterContext, IN PPNDIS_PACKET PacketArray, IN UINT NumberOfPackets );

MiniportSendPackets은 만약 드라이버가 MiniportSend, MiniportWanSend, MiniportCoSendPackets 함수를 가지지 않는다면은 필요한 함수이다. MiniportSendPackets은 네트워크을 걸쳐 패킷 포인터들의 배열로서 지정된 몇몇 패킷들을 전송한다.

매개변수

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정된 NIC 당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

PacketArray

패킷 배열내에서 각 요소를 가리킨다. 전송되어지는 패킷을 위해 패킷 디스크립터의 주소를 지정하는 각 요소로서, 패킷 우선권, 선택적인 타임 스탬프, MiniportSendPackets에 의해 설정된 패킷 당 상태와 같은 정보를 포함하는 관련된 out-of-band 데이터 블럭과 같은.

NumberOfPackets

PacketArray에서 패킷 디스크립터들에 대한 포인터들 수를 지정한다.

주석

만약 드라이버가 MiniportSendPackets 와 MiniportSend를 초기화할 때 등록한다면은, NDIS는 항상 MiniportSendPackets 함수를 호출한다. 만약 드라이버가 MiniportSendPackets 와 MiniportCoSendPackets 함수들을 등록한다면은, NDIS는 어떤 바인드된 프로토콜이 NdisCoSendPackets을 호출할 때 MiniportCoSendPackets 함수를 호출한다.

입력 패킷 패킷 디스크립터 포인터들은 패킷 배열을 설정한 프로토콜 드라이버에 의해 패킷들이 네트워크를 걸쳐 보내어지질 순서에 따라 순서화되어진다. NDIS 라이브러리는 MiniportSendPackets에 각 패킷 배열을 제출할 때 프로토콜 결정 순서들을 보전한다.

결과적으로, MiniportSendPackets은 각 패킷을 어떤 주어진 배열에서 순서적으로 전송해야 한다. MiniportSendPackets은 패킷에 연결된 버퍼 디스크립터들 수와 요구된 전송의 바이트들 총 크기와 같은 정보를 얻기 위해(extract) NdisQueryPacket을 호출할 수 있다. 전송되어질 데이터에 포함한 각 버퍼들에 대한 정보를 빼오기 위해 NdisGetFirstBufferFromPacket, NdisQueryBuffer, NdisQueryBufferOffset를 호출할 수 있다. Mi

niportSendPackets은 관련된 NDIS_GET_PACKET_TIME_TO_SEND 와 NDIS_GET_MEDIA_SPECIFIC_INFO 매크로들을 사용함으로써 각 패킷과 관련된 어떤 프로토콜 제공 out-of-band 정보를 검색할 수 있다.

각 프로토콜 드라이버는 아래 드라이버의 MiniportSendPackets 함수에서 NIC으로 전달하기 위해 설정된 패킷 디스크립터들로 패킷 배열들을 설정할 수 있다. 즉, 프로토콜은 프로토콜이 바인드되어지는 미니포트에 의해 선택되어지는 미디엄 타입에 토대로 요구되어지는 것이 무엇인지를 결정하는 책임을 진다. 그러나 프로토콜은 MiniportSend가 만약 미디엄이 전송할 것들에 대해 최소 길이 요구를 한다면은 pad 해야 되는 선택된 미디엄을 위해 최소보다 작게 연결된 버퍼 디스크립터들에 의해 맵된 net 패킷들을 제공할 수 있다.

높은 계층 프로토콜과 아래 계층 NIC 드라이버상에 있는 어떤 NDIS intermediate 드라이버는 어떤 프로토콜 드라이버로서 아래 미니포트와 선택된 미디엄에 요구들에 따라 패킷들을 설정하기 위해 같은 책임을 가진다. 그러한 인터미디엇 드라이버는 인터미디엇 드라이버에 의해 할당된 fresh 패킷 디스크립터내에서 각 들어오는 보내기 패킷을 repackage를 해야 한다.

MiniportSendPackets는 단지 자신의 목적을 위해 NDIS_PACKET 구조체내에 MiniportReserved에 8바이트 영역을 사용할 수 있다. 결과적으로, 보내기 요구들을 아래 NIC 드라이버에 보내기 요구들을 포워드하는 NDIS 인터미디엇 드라이버는 인터미디엇 드라이버가 패킷 pool로부터 할당한 fresh 패킷 디스크립터들내에 MiniportSendPackets 함수에 대한 주어진 패킷들을 repackage해야 하고 그래서 아래 미니포트는 사용할 수 있는 MiniportReserved 영역을 가진다.

아래 드라이버의 MiniportQueryInformation 함수가 NDIS_MAC_OPTION_NO_LOOPBACK 플래그를 NDIS 라이브러리가 OID_GEN_MAC_OPTIONS를 쿼리할 때 설정한다면은, 미니포트는 어떤 패킷들을 루프백 시도를 하지 않을 것이다. NDIS 라이브러리는 그러한 드라이버를 위해 소프트웨어 루프백 지원을 제공한다.

드라이버가 직렬화된 혹은 비직렬화된 것인지는 어떻게 MiniportSendPackets 함수가 이러한 드라이버 함수가 호출되어질 때 입력 패킷 디스크립터의 완성을 다루는지를 결정한다.

Serialized Miniports

직렬화된 드라이버의 MiniportSendPackets 함수는 입력 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA 블럭의 Status 멤버내에 다음의 값들 중에 하나를 설정한다:

NDIS_STATUS_SUCCESS

드라이버는(혹은 NIC) 전송을 위한 패킷 데이터를 수락해서 MiniportSendPackets이 NDIS가 이러한 요구로 행해진 프로토콜에 리턴될 패킷과 관련된 out-of-band 데이터가 리턴될 것이다.

NDIS_STATUS_PENDING

드라이버는 NdisMSendComplete로 비동기적으로 전송 연산을 완성할 것이다.

NDIS_STATUS_RESOURCES

직렬화된 미니포트는 현재 자원 제한에 기인해서 전송 연산을 설정할 수 없지만은 NDIS는 이 패킷을 큐에 저장해야 하고 드라이버가 다음에 NdisMSendResourcesAvailable 혹은 NdisMSendComplete을 호출할 때 MiniportSendPackets에 대한 다시 제출을 위한 주어진 배열내에서 모든 남아있는 패킷들을 큐에 저장해야 한다.

MiniportSendPackets이 입력 배열에서 패킷을 위한 이러한 값을 설정할 때, NDIS 라이브러리는 배열내에 모든 남아 있는 패킷들이 같은 상태 설정을 가지고 있고 그래서 NDIS가 프로토콜 결정 패킷 배열의 순서를 유지하는 같은 순서로 관련된 패킷들을 다시 큐에 저장한다. NDIS는 이 상태를 프로토콜에 이러한 패킷을 위해 그리고 주어진 배열내에 모든 남아 있는 패킷들을 위해 NDIS_STATUS_PENDING으로 반영한다.

NDIS_STATUS_FAILURE

주어진 패킷이 NIC에 유효하지 않거나 받아들일 수 없다. 이러한 상태를 세팅하는 것 혹은 패킷을 위해 어떤 다른 드라이버 결정 NDIS_STATUS_XXX 에러 값은 NDIS가 실패된 보내기 요구로서 할당하는 프로토콜로 리턴하는 패킷을 완성한다.

MiniportSendPackets이 제어를 리턴할 때, 직렬화된 드라이버는 더 이상 다음은 예외사항들에서 주어진 패킷 배열내에 어떤 것에 접근할 수 있다.

• 만약 MiniportSendPackets은 패킷의 Status가 NDIS_STATUS_PENDING로 설정한다면은, 미니포트는 패킷 디스크립터와 어떤 관련된 out-of-band 데이터 블럭내에 미디어 특정 정보에 접근할 수 있다. MiniportSendPackets은 마찬가지로 패킷 디스크립터에 연결된 버퍼 디스크립터들과 사용할 수 있다.

  드라이버가 전송 연산의 마지막 상태로 NdisMSendComplete를 호출한 후에, 주어진 패킷 디스크립터의 소유권, out-of-band 데이터 블럭, 관련된 버퍼들은 할당하는 프로토콜이다. 미니포트는 결코 NdisMSendComplete에 전달하는 패킷을 위해 NDIS_STATUS_RESOURCES를 리턴할 필요가 없다.

• 만약 MiniportSendPackets은 NDIS_STATUS_RESOURCES로 패킷을 위한 Status를 설정한다면은, 미니포트는 패킷 디스크립터, 관련된 out-of-band 데이터 블럭, NDIS가 MiniportSendPackets에 대한 패킷 배열의 연속된 요소에 따라 보내기 요구를 다시 제출할 때, 그러한 패킷에 연결된 버퍼 디스크립터들을 접근할 수 있다.

디폴트로, 직렬화된 미니포트의 MiniportSendPackets은 IRQL DISPATCH_LEVEL에서 실행한다.

비직렬화된 미니포트들

NDIS 라이브러리는 비직렬화된 드라이버들의 MiniportSendPackets 함수들에 제출하는 모든 패킷 디스크립터내에 OOB 블럭을 무시하고 모든 비직렬화된 미니포트들은 NdisMSendComplete로 비동기적으로 그들의 MiniportSendPackets 함수들로 각 패킷 디스크립터 입력으로 완성할 것이다. 결과적으로, 그러한 비직렬화된 드라이버의 MiniportSendPackets 함수는 항상 NDIS_PACKET_OOB_DATA 블럭의 Status 멤버를 무시하지만, 이 멤버를 계속적으로 NdisMSendComplete에 전달하는 같은 상태로 설정할 수 있다.

MiniportSendPackets이 주어진 패킷들을 전송하기 위해 불충분한 자원들을 가질 때마다 보내기 패킷들을 큐에 저장하고 다시 제출하는 것을 NDIS에게 의존하는 것보다 오히려 비직렬화된 미니포트는 자신의 내부 패킷 큐에 저장하는 것을 관리한다. 그러한 드라이버는 그들이 네트워크을 걸쳐 보내어질 수 있을 때까지 내부 큐에 들어오는 보내기 패킷들을 유지하고 MiniportSendPackets 함수에 들어오는 패킷 디스크립터들의 프로토콜 결정 순서대로 보존하는 책임을 진다.

비직렬화된 미니포트는 NdisMSendComplete로 각 들어오는 보내기 패킷을 완성해야 하고 NdisMSendResourcesAvailable을 호출할 수 없다. 비직렬화된 미니포트는 원래 MiniportSendPackets 함수에 제출된 프로토콜 할당 패킷 디스크립터로 NdisMSendComplete에 STATUS_INSUFFICIENT_RESOURCES를 전달할 필요가 없다. 그러한 리턴된 상태는 프로토콜에 의해 요구된 보내기 연산을 실패하고, NDIS는 패킷 디스크립터와 원래 그것을 할당한 프로토콜에 대한 모든 관련된 자원들을 리턴할 것이다.

비직렬화된 미니포트의 MiniportSendPackets 함수는 어떤 IRQL <= DISPATCH_LEVEL로 호출되어질 수 있다. 결과적으로, 비직렬화된 드라이버의 MiniportSendPackets 함수는 같은 큐들에 접근하는 드라이버의 다른 MiniprotXxx 함수들로 패킷 디스크립터들의 내부 큐에 접근을 동기화하는 책임을 진다.