MiniportReturnPacket

VOID MiniportReturnPacket( IN NDIS_HANDLE MiniportAdapterContext, IN PNDIS_PACKET Packet );

MiniportReturnPacket은 NdisM(Co)IndicateReceivePacket으로 수신들을 인디케이트하는 드라이버에서 필요한 함수이다.

매개변수

MiniportAdapterContext

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

Packet

전에 이 포인터에 포함된 패킷 배열을 가리키는 미니포트에 의해 리턴되어지는 패킷 디스크립터를 가리킨다.

주석

드라이버들의 다음 타입들은 MiniportReturnPacket 함수를 제공해야 한다:

• 멀티 패킷 리시브들을 지원하는 버스 마스터 DMA NIC의 미니포트 드라이버. 그러한 드라이버들은 MiniportSendPackets 함수를 익스포트하는 직렬화된 미니포트들을 포함한다. 직렬화된 미니포트, 연결 지향 미니포트.
• 리시브 인디케이션들과 같은 패킷 우선권과 같은 미디어 특정 정보를 제공하는 미니포트 드라이버
• MiniportReturnPacket 함수를 제공하는 그 자체와 미니포트를 바인드하는 NDIS 인터미디엇 드라이버

직렬화된 드라이버

상태가 NdisMIndicateReceivePacket으로부터 리턴한 NDIS_STATUS_PENDING으로 설정한 NDIS_PACKET_OOB_DATA와 관련된 어떤 리시브 패킷은 MiniportReturnPacket에게 리턴되어질 것이다. 모든 바인드된 프로토콜들은 원래 인디케이트된 패킷 배열에 대한 참조들을 해제하는데 필요한 만큼 NdisReturnPackets을 호출할 때, NDIS는 원래 패킷 배열을 할당한 드라이버의 MiniportReturnPacket 함수에 대한 배열로부터 지연된 패킷들을 리턴한다.

만약 NdisMIndicateReceivePacket으로 리시브 패킷 디스크립터를 인디케이딩하기 전에 드라이버가 디스크립터와 관련된 NDIS_PACKET_OOB_DATA로 리턴된 상태 멤버를 NDIS_STATUS_SUCCESS로 드라이버가 설정된다면은, 드라이버는 NdisMIndicateReceivePacke의 리턴으로 패킷의 상태를 체크해야 한다:

• 만약 Status가 NDIS_STATUS_SUCCESS로 설정된다면은, 패킷 디스크립터와 관련된 버퍼 디스크립터들은 드라이버에게로 리턴되어진다.
• 만약 Status가 NDIS_STATUS_PENDING으로 설정된다면은, NDIS는 드라이버의 MiniportReturnPacket 함수에게 패킷 디스크립터를 리턴할 것이다.

For Deserialized and Connection-Oriented Drivers

만약 드라이버가, NdisM(Co)IndicateReceivePacket으로 리시브 패킷 디스크립터를 인디케이트 하기전에, 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA의 Status 멤버를 NDIS_STATUS_SUCCESS로 설정한다면은, NDIS는 드라이버의 MiniportReturnPacket 함수에 대한 패킷 디스크립터를 리턴한다. 그러나, 만약 미니포트가 Status 멤버를 NDIS_STATUS_RESOURCES로 설정된다면은, 그러므로 패킷 디스크립터와 관련된 버퍼 디스크립터들의 소유를 유지할 필요가 있다는 것을 가리키기 위해, NDIS는 암연적으로, NdisM(Co)IndicateReceivePacket의 리턴으로 드라이버에게 패킷 디스크립터를 리턴한다.

비직렬화된 혹은 연결 지향 미니포트 드라이버는 NdisMIndicateReceivePacket의 리턴으로 인디케이트된 패킷들의 상태들을 조사할 필요가 없다. 그러나, 비직렬화된 미니포트 드라이버는 패킷 디스크립터가 인디케이딩하기 전에 지역 변수내에 패킷 상태를 저장해야 한다. NdisMIndicateReceivePacket이 리턴될 때, 미니포트 드라이버는 저장된 패킷 Status를 체크해야 한다. 만약 미니포트 드라이버는 패킷 디스크립터가 인디케이팅 하기 전에, 패킷의 Status가 NDIS_STATUS_RESOURCES로 설정된다면은, 그것은 즉시 NdisMIndicateReceivePacket을 리턴한 후, 자신의 MiniportReturnPacket 함수를 호출함으로써 패킷 디스크립터를 주장해야 한다. 이러한 경우에, NDIS는 패킷 디스크립터를 리턴하기 위해 미니포트 드라이버의 MiniportReturnPacket 함수를 호출하지 않는다. 만약 미니포트 드라이버가 패킷 디스크립터를 인디케이팅(indicating up)하기 전에 패킷의 Status를 NDIS_STATUS_SUCCESS로 설정한다면은, 미니포트 드라이버는 NDIS가 계속해서 미니포트 드라이버의 MiniportReturnPacket 함수에 대한 패킷 디스크립터를 리턴할 때까지 패킷 디스크립터를 요구할 필요가 없다.

For All Drivers

항상, MiniportReturnPacket은 그러한 리턴된 패킷이 연속된 리시브 인디케이션에서 사용된 것처럼 준비한다. 비록 MiniportReturnPacket이 버퍼 풀에 패킷이 연결된 버퍼 디스크립터들과 패킷 풀에 그것을 패킷 디스크립터를 리턴할 수 있지만은, 리턴된 디스크립터들을 재사용하는 것은 더 효율적이다.

MiniportReturnPacket은 NdisReinitializePacket을 호출하기 전에 모든 연결된 버퍼 디스크립터들에 대한 포인터들을 저장하기 위해 필요한 만큼 NdisUnchainBufferAtXxx를 호출해야 한다. 그렇지 않으면은, MiniportReturnPacket은 드라이버가 원래 인디케이션을 위해 패킷을 연결한 버퍼디스크립터들을 회복할 수 없다.

MiniportReturnPacket은 또한 재사용을 위해 패킷과 관련된 out-of-band 블럭을 준비하기 위해 NDIS_OOB_DATA_FROM_PACKET 에 의해 리턴된 포인터로 NdisZeroMemory를 호출할 수 있다.

만약 특정 버퍼 디스크립터가 인디케이트된 범위의 데이터 크기가 일치하는데 짧다면은, MiniportReturnPackt은 NIC의 리시브 버퍼 범위에 맴핑을 회복하기 위해 버퍼 디스크립터오 NdisAdjustBufferLength를 호출해야 한다.

디폴트로 MiniportReturnPacket은 IRQL DISPATCH_LEVEL를 실행한다.