NdisGetReceivedPacket

PNDIS_PACKET NdisGetReceivedPacket( IN PNDIS_HANDLE NdisBindingHandle, IN PNDIS_HANDLE MacContext );

NdisGetReceivedPacket 함수는 하부의 드라이버로부터 리시브된 패킷을 얻는다.

매개변수

NdisBindingHandle

바인딩되는 타겟 NIC이나 가상 어댑터의 하부 드라이버를 확인시키는 NdisOpenAdapter 함수에 의해서 리턴된 핸들을 서술한다.

MacContext

하부의 드라이버가 네트웍으로부터 리시브된 패킷과 연관하는 컨텍스트 핸들을 서술한다. 이 핸들은 ProtocolReceive 함수의 입력 파라미터로 전달된다. 이 핸들은 호출하는 드라이버에게는 불투명하고 인디케이션하는 하부의 드라이버가 사용하기 위해서 예약된다.

리턴값

하부의 드라이버에서 리시브된 데이타를 포함하는 패킷 디스크립터의 포인터를 리턴한다.

주석

몇몇 프로토콜 혹은 인터미디엇 드라이버는 하나의 NIC과 바인딩될 수 있고 그러한 각각의 드라이버는 똑같은 패킷을 리시브할 수 있다. 그러한 패킷은 이들 드라이버에게는 읽기전용이다. 각각의 그러한 드라이버의 ProtocolReceive 함수는 NdisGetReceivedPacket 함수를 호출하므로써 인디케이트된 패킷을 얻어 올 것인지를 결정한다.

NdisGetReceivedPacket 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.