ProtocolCoReceivePacket

UINT ProtocolCoReceivePacket( IN NDIS_HANDLE ProtocolBindingContext, IN NDIS_HANDLE ProtocolVcContext, IN PNDIS_PACKET Packet );

ProtocolCoReceivePacket 함수는 NdisMCoIndicateReceivePacket 함수를 호출하는 아래 드라이버들에 의해 만들어진 수신 인디케이션들을 처리하는데 필요한 함수이다.

매개변수

ProtocolBindingContext

프로토콜 드라이버가 바인딩 당 런타임 정보를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 드라이버는 NdisOpenAdapter 함수를 호출할 때 이러한 핸들을 제공한다.

ProtocolVcContext

이러한 드라이버가 VC당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 클라이언트 혹은 혼자의 콜 매니저는 NdisCoCreateVc 함수를 호출할 때 혹은 ProtocolCoCreateVc 함수로부터 이 핸들을 제공한다.

Packet

수신된 네트워크 패킷을 위한 패킷 디스크립터의 포인터를 가리킨다. NDIS는 아래 드라이버가 NdisMCoIndicateReceivePacket 함수로 전달된 패킷 디스크립터 포인터들의 배열로부터 이러한 포인터를 뽑아낸다.

리턴값

ProtocolCoReceivePacket 함수는 이러한 프로토콜이 NDIS가 이러한 자원들을 할당한 아래 드라이버에 패킷 자원들을 리턴할 수 있기 전에 계속해서 얼마나 여러번 NdisReturnPackets을 호출해야 하는지 NDIS에게 가리키는 드라이버 결정 값을 리턴한다.

주석

아래 연결 지향 NIC 드라이버와 바인드된 프로토콜 드라이버는 ProtocolCoReceivePacket 함수를 가져야 한다. 그러한 아래 미니포트는 항상 full-packet 수신들을 인디케이트한다.

ProtocolCoReceivePacket 함수는 Packet에 의해 가리켜진 배열내에 각 패킷 디스크립터을 위해 한번 NDIS_GET_PACKET_STATUS 매크로를 호출해야 한다. NDIS_GET_PACKET_STATUS 매크로는 패킷 디스크립터와 관련된 OOB 블럭 Status를 얻는다.

만약 아래 NIC 드라이버가 NdisMCoIndicateReceivePacket 함수를 호출하기 전에, NDIS_STATUS_SUCCESS로 OOB 블럭 Status를 설정한다면, NIC 드라이버는 일시적으로 패킷 디스크럽터와 관련된 자원들의 소유권을 양도한다. 이러한 경우에, 프로토콜은 (혹은 가상 상위 프로토콜인 TDI 클라이언트들) 만약 ProtocolCoReceivePacket 함수가 0이 아닌 값을 리턴한다면, Packet으로 지정된 주어진 읽기 모드 접근인 모든 수신된 데이터를 유지할 수 있다. 입력 Packet 디스크립터 포인터를 몇몇 관심있는 클라이언트들에게 포워드하는 가상 상위 레벨 프로토콜을 위해, 각 클라이언트는 클라이언트가 TdiReturnChainedReceives를 호출할 때까지 관심있는 데이로 읽기 모드 접근을 유지한다. 프로토콜 드라이버는 ProtocolCoReceivePacket 에 의해 리턴된 참조 카운트 만큼 Packet을 가진 NdisReturnPackets 함수를 호출할 때까지 인디케이트된 패킷의 소유권을 유지한다.

만약 ProtocolCoReceivePacket 함수가 NdisReturnPackets 함수를 호출하지 않는다면, 프로토콜은 ProtocolCoReceivePacket 함수가 제어를 리턴하기 후 NdisReturnPackets 함수에 대한 입력 Packet 포인터를 전달해야 한다. 이러한 시나리오에서, ProtocolCoReceivePacket 함수는 0이 아닌 값을 리턴할 때 ProtocolBindingContext 영역에 입력 Packet 포인터를 저장해야 한다.

NDIS 라이브러리는 그러한 인디케이트된 패킷을 위해 참조 카운트를 유지하고 프로토콜은 ProtocolBindingContext 함수에 의해 리턴된 값만큼 그러한 패킷으로 NdisReturnPackets 함수를 호출할 때까지 패킷의 유지권을 소유한다.

ProtocolCoReceivePacket 함수는 만약 인디케이트된 패킷에 관심이있는 현 클라이언트들은 혹은 바인드된 상위 레벨 프로토콜들 없거나 ProtocolCoReceivePacket 함수가 주어진 패킷과 관련된 프로토콜 할당 저장공간에 대역외 블럭으로부터 데이터를 복사한다면 주어진 Packet의 소유권을 양도하기 위해 0을 리턴한다. ProtocolCoReceivePacket 함수가 0을 리턴할 때, NDIS는 수신 인디케이션으로 또하나의 바인드된 프로토콜을 호출하거나 인디케이션을 만든 미니포트에게 Packet 인 주어진 패킷 디스크럽터를 리턴한다.

아래 NIC이 자원이 부족한 상태로 실행할 때, 패킷 디스크립터의 관련된 OOB 블럭 Status를 NDIS_STATUS_RESOURCES로 설정한다. 이것은 ProtocolCoReceivePacket 함수에게 NIC 드라이버 할당 패킷 자원들을 유지하는 것보다 오히려 패킷 데이터를 복사하도록 한다. ProtocolCoReceivePacket 함수는 그러한 상황에서 0을 리턴해야 한다.

만약 아래 미니포트가 추가적인 수신들을 위한 대역폭외 정보를 제공한다면, ProtocolCoReceivePacket 함수는 적당한 NDIS_GET_PACKET_XXX 매크로로 주어진 Packet을 위한 관련된 대역외 정보를 검색할 수 있다.

ProtocolCoReceivePacket 함수는 IRQL DISPATCH_LEVEL로 실행할 수 있도록 쓰여져야 한다.