MiniportCoSendPackets
VOID
MiniportCoSendPackets(
IN NDIS_HANDLE MiniportVcContext,
IN PPNDIS_PACKET PacketArray,
IN UINT NumberOfPackets
);
|
MiniportCoSendPackets은 연결 지향 미니포트들을 위해 필요한 함수이다.
MiniportCoSendPackets는 네트워크를 걸쳐 포인터 배열로 지정된 몇개의 패킷들을 전송하기 위해
호출되어진다.
매개변수
- MiniportVcContext
- 미니포트는 VC당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 미니포트는
MiniportCoCreateVc 함수로부터 NDIS에게 이 핸들을 제공한다.
- PacketArray
- 패킷 배열내에 초기 요소들에 대한 것을 가리킨다. 전송되는 패킷을 위한 패킷 디스크립터의 주소을
지정하는 각 요소이다. 패킷 우선권, 선택인 타임스탬프, 패킷 당 상태 MiniportCoSendPackets에 의해
설정된, 과 같은 정보를 포함하는 관련된 아웃오브밴드 데이터 블럭과 함계,
- NumberOfPackets
- PacketArray에서 패킷 디스크립터들에 대한 포인터 수를 가리킨다.
주석
MiniportCoSendPackets은 네트워크를 가로질러 데이터 패킷들의 순서화된 리스트로 보내기 위해
바운드된 프로토콜 드라이버에 의한 요구에 대한 응답으로 NDIS에 의해 호출되어진다.
MiniportCoSendPackets은 연속적으로 어떤 주어진 배열에서 각 패킷을 전송해야 한다. MiniportCoSendPackets은
패킷에 연결 많은 버퍼 디스크립터들과 요구된 전송으 바이트의 총 크기같은 정보를 뽑아내기 위해
NdisQueryPacket을 사용할 수 있다.
이 함수는 전송될 데이터를 포함한 각각의 버퍼들에 대하여 정보를 뽑아내기 위해 NdisGetFirstBufferFromPacket,
NdisQueryBuffer, NdisQueryBufferOffset를 호출할 수 있다.
MiniportCoSendPackets은 적당한 NDIS_GET_PACKET_XXX 매크로들을 사용함으로써 각 패킷과 관련된 프로토콜 제공
아웃오브밴드 정보를 검색할 수 있다.
MiniportCoSendPackets은 자기 자신의 목적을 위해 NDIS_PACKET 구조체내에 MiniportReserved에 단지 8바이트 영역을
사용할 수 있다.
NDIS 라이브러리는 MiniportCoSendPackets에 제출된 모든 패킷 디스크립터들에서 OOB 블럭을 무시하고
모든 연결 지향 미니포트는 NdisMCoSendComplete로 비동기적인 각 입력 패킷 디스크립터을 완성하기 위하여
비직렬화된 드라이버라고 생각한다.
결과적으로, 그러한 비직렬화된 드라이버의 MiniportCoSendPackets 함수는 항상 NDIS_PACKET_OOB_DATA 블럭의
Status 멤버를 무시하지만은 이 함수는 결과적으로 NdisMConSendComplete에 전달하는 같은 상태값으로 이 멤버를
설정할 수 있다.
MiniportCoSendPackets이 주어진 패킷들을 전송하기 위해 충분하지 못한 자원들을 가질때마다 보내는 패킷들을 큐에
저장하거나 다시 제출하기 위해 NDIS에 의존하는 것보다 오히려 비직렬화된 미니포트는 자신의 내부 패킷 큐 구조를
관리한다. 그러한 드라이버는 그들이 네트워크을 걸쳐 전송되어질 수 있을 때까지 내부 큐에 들어오는 보내기 패킷들을
유지하는 책임을 져야 하고 MiniportCoSendPackets 함수에게 들어오는 패킷 디스크립터들의 프로토콜 결정 순서로
보존해야 한다.
비직렬화된 미니포트는 NdisMCoSendComplete로 각 들어오는 보내기 패킷을 완성해야 하고
이 함수는 NdisMSendResourceAvailable를 호출할 수 없다.
비직렬화된 미니포트는 원래 MiniportCoSendPackets 함수에 제출된 프로토콜 할당 패킷디스크립터에 NdisMCoSendComplete로
STATUS_INSUFFICIENT_RESOURCES를 결코 전달할 필요가 없다.
그러한 리턴된 상태는 효율적으로 프로토콜에 의해 요구된 보내기 연산을 실패하고 NDIS는 패킷 디스크립터와 원래 그것을
할당한 프로토콜에 대한 모든 관련된 자원들을 리턴할 것이다.
MiniportCoSendPackets은 IRQL <= DISPATCH_LEVEL에서 호출되어질 수 있다. 결과적으로, MiniportCoSendPackets 함수는
또한 같은 큐들에 접근하는 드라이버의 다른 MiniportXxx 함수들과 패킷 디스크립터들의 내부 큐에 대한 접근을
동기화해야 한다.
|