MiniportSend

NDIS_STATUS MiniportSend( IN NDIS_HANDLE MiniportAdapterContext, IN PNDIS_PACKET Packet, IN UINT Flags );

MiniportSend는 만약 드라이버가 MiniportSendPackets, MiniportWanSend, 혹은 MiniportCoSendPackets 함수를 가지지 않는다면은 필요한 함수이다. MiniportSend는 네트워크을 걸쳐 프로토콜 제공 패킷을 전송한다.

매개변수

MiniportAdapterContext

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

Packet

전송될 데이터를 지정하는 패킷 디스크립터를 가리킨다.

Flags

프로토콜에 의해 설정되는 패킷 플래그들을 지정한다.

리턴값

MiniportSend는 다음과 같은 어떤 값을 리턴할 수 있다:

NDIS_STATUS_SUCCESS

드라이버는 (혹은 NIC) 전송을 위한 패킷 데이터를 수락하고, NDIS가 피로토콜에게 리턴할 패킷을 MiniportSend는 리턴한다.

NDIS_STATUS_PENDING

드라이버가 NdisMSendComplete에 대한 호출로 비동기적으로 패킷을 완성할 것이다.

NDIS_STATUS_RESOURCES

드라이버(혹은 NIC)은 현재 주어진 패킷을 처리하기 위해 이용할 수 있는 자원이 불충분하다면은 NDIS는 드라이버가 다음 NdisMSendResourcesAvailable 혹은 NdisMSendComplete를 호출할 때 다시 제출을 위해 보내기 패킷을 큐에 저장해야 한다.

만약 비직렬화된 미니포트는 MiniportSend 함수로부터 NDIS_STATUS_RESOURCES를 리턴한다면은, NDIS는 에러 상태로 프로토콜에 주어진 패킷을 되돌려 리턴한다.

NDIS_STATUS_NO_CABLE

NIC이 네트워크 케이블이 NIC으로부터 연결이 안되었기 때문에 보내기 연산을 실패한다.

NDIS_STATUS_FAILURE

주어진 패킷이 NIC에게 유효하지 않거나 허락할 수 없다. MiniportSend는 만약 적당하게 실패를 설명하는 NDIS_STATUS_XXX 값이 없다면은 NDIS_STATUS_FAILURE로 리턴해야 한다. Preferably, MiniportSend는 실패의 특정 이유를 인디케이트하는 NDIS_STATUS_XXX 값을 리턴해야 한다.

주석

만약 드라이버가 초기화할 때 MiniportSend와 MiniportSendPackets 둘 다를 등록한다면은, MiniportSend 함수는 결코 NDIS에 의해 호출되지 않는다.

MiniportSend는 안전하게 패킷과 주어진 패킷이 완성될 때까지 패킷에 연결된 모든 버퍼 디스크립터들에 접근할 수 있다. 만약 MiniportSend가 NDIS_STATUS_PENDING과는 다른 혹은 직렬화된 드라이버의 NDIS_STATUS_RESOURCES로 상태가 리턴된다면은, 요구는 완성이 고려되어지고 패킷 디스크립터의 소유권과 패킷과 관련된 모든 메모리는 할당한 프로토콜로 바뀐다.(reverts to)

만약 비직렬화된 드라이버의 MiniportSend 함수가 NDIS_STATUS_RESOURCES를 리턴한다면은, 요구는 또한 완성으로 여겨진다. 그러한 비 직렬화된 드라이버의 MiniportSend 함수는 만약 드라이버가 현재 그것을 전송하기 위해 불충분한 자원을 가지고 있고 패킷이 유효하다면은 내부적으로 주어진 패킷을 큐에 저장해야 한다. 이러한 환경아래에서, MiniportSend는 큐에 저장된 패킷을 위해 NDIS_STATUS_PENDING을 리턴해야 하고 계속해서 패킷을 전송되어질 때 NdisMSendComplete 호출해야 한다. 비직렬화된 미니포트는 NdisMSendResourcesAvailable를 호출할 수 없다.

MiniportSend가 NDIS_STATUS_PENDING을 리턴한다면은, 드라이버는 계속해서 NdisMSendComplete를 호출함으로써 요구의 완성을 신호화해야 한다. MiniportSend가 NDIS_STATUS_RESOURCES가 리턴할 때, NDIS 라이브러리는 만약 드라이버가 직렬화되어진다면은, NDIS_STATUS_PENDING으로 프로토콜에 대한 이러한 상태를 반영한다.

직렬화된 드라이버가 NDIS_STATUS_RESOURCES로 패킷을 리턴할 때, MiniportSend 함수에 제출된 다음 패킷은 NDIS 에게 리턴된 같은 패킷이다. 결과적으로, MiniportSend는 만약 드라이버가 현재 그 정보를 저장하기 위해 충분한 자원들을 가지고 있다면은 그러한 리턴된 패킷에 대해 정보를 보유하게 함으로써 최적화할 수 있다. NDIS는 MiniportSend가 직렬화된 드라이버가 처음 발생에서, NdisMSendResourcesAvailable 혹은 NdisMSendComplete를 호출하자마자 그러한 패킷을 받아들이는 준비가 되있다고 추측한다.

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

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

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

MiniportSend는 요구된 전송의 바이트로 총 크기와 패킷에 연결된 버퍼 디스크립터의 수와 같은 정보를 뽑기 위해 NdisQueryPacket을 호출한다. 전송될 데이터에 포함하는 각 버퍼들에 대해 정보를 뽑기 위해 NdisGetFirstBufferFromPacket, NdisQueryBuffer, NdisQueryBufferOffset를 호출할 수 있다.

Flags 매개변수들은 패킷 데이터내에 포함하지 않는 보내기에 대해 정보를 제공할 수 있다. 현재, 시스템 정의 플래그들이 없지만은, 더 가깝게 커플된 프로토콜와 미니포트 드라이버 쌍은 이러한 MiniportSend가 NdisGetPacketFlags로 검색할 수 있는 매개변수내에 정보를 전달할 수 있다. 그러나, 그러한 드라이버 쌍은 각 패킷 디스크럽터와 관련된 NDIS_PACKET_OOB_DATA 블럭내에서 타임스탬프들과 패킷 우선권같은 더 많은 정보를 통신할 수 있다.

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

MiniportSend는 인터럽트에 의해 선점될 수 있다.

디폴트로, MiniportSend는 IRQL DISPATCH_LEVEL을 실행한다.