ProtocolReceivePacket

INT ProtocolReceivePacket( IN NDIS_HANDLE ProtocolBindingContext, IN PNDIS_PACKET Packet );

ProtocolReceivePacket 함수는 아래 드라이버가 멀티 패킷 수신 인디케이션들을 지원하기 때문에 패킷 배열들로 혹은 대역폭 외 정보와 관련된 각 패킷들로 NdisMIndicateReceivePacket 함수를 호출하는 아래 비연결지향주의 NIC 드라이버들에 의해 만들어진 수신 인디케이션들을 처리하는 선택적인 함수이다. ProtocolReceivePacket 함수는 loopback의 결과로서 일어날 수 있다.

아래 연결 지향 NIC 미니포트들과 배타적으로 그들 자신을 바인드하는 프로토콜들은 완전한 기능의 ProtocolReceivePacket 함수보다 ProtocolCoReceivePacket 함수를 가져야 한다.

매개변수

ProtocolBindingContext

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

Packet

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

리턴값

ProtocolReceivePacket함수는 Protocol이 계속해서 주어진 패킷으로 NdisReturnPacket 함수를 호출한 만큼 혹은 만약 프로토콜이 이러한 패킷내에 관심이 없거나 완성되면 0으로 NDIS에게 말하는 드라이버 결정 값을 리턴한다.

주석

그자체와 멀티 패킷 수신 인디케이션들을 지원하는 아래 비연결 지향 NIC 드라이버와 바인드하는 프로토콜 드라이버는 ProtocolReceivePacket 함수를 가져야 한다. 그러한 아래 드라이버는 항상 full 패킷 수신들을 인디케이트한다.

프로토콜은 만약 ProtocolReceivePacket 함수를 가진다면 더 높은 퍼포먼스를 성취할 수 있다. 그러한 프로토콜은(혹은 가상 높은 윈도우즈 2000 프로토콜의 TDI 클라이언트들) 만약 ProtocolReceivePacket이 0이 아닌 값을 리턴한다면 Packet으로 지정된 주어진 읽기 전용 접근으로 모든 수신된 데이터를 유지할 수 있다. 가장 높은 레벨 윈도우즈 2000 프로토콜 드라이버를 위해, 그러한 입력 Packet 디스크립터 포인터를 위해 리턴 값은 프로토콜이 입력 패킷 디스크립터로 포워딩함으로써 수신된 네트워크 패킷에 대해 알리는 클라이언트들의 참조 카운트가 될 수 있다. 인터미디엇 NDIS 드라이버에 대해, 리턴값은 응답하는 인디케이션을 하는 가장 높은 레벨 프로토콜들의 카운트가 될 것이고 혹은 만약 드라이버가 처리된 인디케이션을 포워드하는 가장 높은 레벨 프로토콜들의 수를 추적한다면 1이다. 입력 패킷 디스크립터 포인터를 몇몇 관심있는 클라이언트에게 포워드하는 가장 높은 레벨 윈도우즈 2000 프로토콜을 위해, 각 클라이언트는 클라이언트가 TdiReturnChainedReceives 함수를 호출할 때까지 수신된 데이터에 대한 읽기 전용 접근을 보류한다. 인터미디엇 드라이버는 ProtocolReceivePacket 함수에 의해 리턴된 참조 카운트만큼 Packet으로 NdisReturnPackets 함수를 호출할 때까지 수신된 패킷의 소유권을 보류한다.

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

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

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

아래 수신들을 위한 대역폭외 정보를 제공하는 비연결 지향 NIC 드라이버와

바인드되는 프로토콜은 수신 인디케이션들을 처리할 때 미니포트 제공 대역폭 정보를 해석하기 위해 ProtocolReceivePacket 함수를 가져야 한다. 그러한 프로토콜은 적당한 NDIS_GET_PACKET_XXX 매크로들로 주어진 Packet을 위해 관련된 대역폭 정보를 검색할 수 있다.

만약 들어오는 패킷 디스크립터가 관련된 OOB 블럭내에 Status를 위한 NDIS_STATUS_RESOURCES 설정을 가진다면, 프로토콜은 패킷 디스크립터와 관련된 미니포트 할당 자원들을 유지할 필요가 없다.

그 대신에 ProtocolReceivePacket 함수는 수신된 데이터가 프로토콜 할당 저장공간내로 복사해야 하고 가능한 한 빨리 NDIS에게 0을 리턴해야 한다. 그러한 미니포트 할당 패킷 디스크립터를 위해 OOB 블럭내에 Status가 미니포트는 수신 자원들을 낮게 운영하는 것을 인디케이트한다.

디폴트로, ProtocolReceivePacket 함수는 arbitrary 쓰레드 컨텍스트내에서 IRQL DISPATCH_LEVEL로 실행한다.