ProtocolReceive

NDIS_STATUS ProtocolReceive( IN NDIS_HANDLE ProtocolBindingContext, IN NDIS_HANDLE MacReceiveContext, IN PVOID HeaderBuffer, IN UINT HeaderBufferSize, IN PVOID LookAheadBuffer, IN UINT LookaheadBufferSize, IN UINT PacketSize );

ProtocolReceive 함수는 그들 자신이 비연결 지향 NIC 드라이버들에 바인드한 NDIS 프로토콜들에서 필요한 드라이버 함수이다. ProtocolReceive 함수는 수신된 네트워크 패킷이 프로토콜 클라이언트들에 관심이 있는지를 결정하고 만약 그렇다면, 인디케이트된 데이터를 복사하고 가능한 인디케이트된 패킷의 나머지를 검색하기 위해 NdisTransferData 함수를 호출한다.

매개변수

ProtocolBindingContext

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

MacReceiveContext

아래 NIC 드라이버는 네트워크으로부터 수신된 패킷과 관련한 컨텍스트 핸들을 지정한다. 이러한 핸들은 NdisTransferData 함수에 필요한 매개변수와 인디케이션을 하는 아래 드라이버에 의해 사용이 예약된 프로토콜에게 불분명하다.

HeaderBuffer

버퍼화된 패킷 헤더를 포함하는 범위의 베이스 가상 주소를 가리킨다. 주소는 ProtocolReceive 함수에 대한 현 호출내에 단지 유효하다.

HeaderBufferSize

패킷 헤더에서 바이트 수들을 지정한다.

LookAheadBuffer

버퍼화된 네트워크 패킷 데이터의 LookaheadBufferSize 바이트들을 포함하는 베이스 가상 주소의 범위를 가리킨다. 이러한 주소는 단지 ProtocolReceive에 대한 현 호출 내에서만 유효하다.

LookaheadBufferSize

lookahead 버퍼내 네트워크 패킷 데이터의 바이트 수들을 지정한다.

인디케이트 하는 드라이버는 이러한 수가 적어도 OID_GEN_CURRENT_LOOKAHEAD로 NdisRequest 함수에 대한 프로토콜의 선행 호출을 위해 리턴한 크기보다 커야 하고 혹은 적어도 패킷의 크기보다 작아야 하는 것을 확실히 해야 한다.

만약 PacketSize가 주어진 LooaheadBufferSize보다 작거나 같다면, lookahead 버퍼는 완전한 패킷을 포함한다. 만약 아래 드라이버가 NdisMIndicateReceivePacket 함수로 인디케이션을 한다면, lookahead 버퍼는 항상 full network 패킷을 포함한다.

PacketSize

네트워크 패킷 데이터의 바이트 크기을 지정한다. 패킷의 길이는 헤더의 길이를 포함하지 않는다.

ProtocolReceive 함수는 프로토콜은 주어진 LookaheadBufferSize 로 이러한 매개변수들을 비교함으로써 NdisTransferData 함수를 호출해야 할지를 결정한다.

리턴값

ProtocolReceive 함수는 다음과 같은 값들 중 하나를 리턴할 수 있다.

NDIS_STATUS_NOT_ACCEPTED

프로토콜은 인디케이트된 패킷을 위해 사용을 하지 않고 즉, 인디케이트된 네트워크 데이터에서 관심있는 현 클라이언트들은 없다.

거절된 패킷들을 위해 빠르게 이러한 상태를 리턴하는 것은 프로토콜을 위해 그리고 전체적으로 시스템을 위해 가장 상위 가능한 네트워크 I/O throughput에 더 높은 퍼포먼스를 낳는다.

NDIS_STATUS_SUCCESS

ProtocolReceive 함수는 헤더 정보를 처리하고 패킷을 수락한다. 즉, 헤더 그리고 lookahead 버퍼들로부터 인디케이트된 데이터를 복사하고 가능한 만약 full 네트워크 패킷보다 작은 값이 인디케이트된다면 남아있는 데이터를 검색하기 위해 NdisTransferData 함수를 호출한다.

주석

NDIS는 아래 비연결지향 NIC 미니포트 위에 바이드된 어떤 수의 프로토콜 드라이버들을 위해 동등한 패킷 접근을 제공한다. NDIS는 ProtocolReceive 함수는 바인드된 프로토콜들은 계속적인 패킷들을 위한 인디케이션들을 수신하는 순서를 최적화하기 위해 리턴한 상태를 사용할 수 있다.

미니포트는 필터 특정 NdisM..IndicateReceive 함수를 호출할 때, NDIS는 바이드된 프로토콜들의 ProtocolReceive 함수들을 호출한다. NdisM..IndicateReceive 함수에 대한 호출은 네트워크 패킷 즉 몇몇 초기화 lookahead 부분은 바인드된 프로토콜에 의한 inspection을 위해 이용할 수 있다는 것을 인디케이트한다. 각 ProtocolReceive 함수는 이번에는 패킷 헤더와 데이터를 선택적으로 조사하고 이용할 수 있는 만큼 헤더와 데이터를 복사하고 NIC 드라이버에게 만약 프로토콜이 패킷을 수락한다면 프로토콜 할당 패킷 디스크립터에 체인화된 프로토콜 제공 버퍼에 어떤 남아있는 데이터를 복사하기 위해 명령하기 위해 NdisTransferData 함수를 호출한다. ProtocolReceive 함수는 수신 인디케이션당 단지 한번 NdisTransferData 함수를 호출할 수 있다.

직렬화된 미니포트는 패킷 배열로부터 NdisMIndicateReceivePacket 함수를 호출하기 전에, 배열에서 패킷 디스크립터와 관련된 대역외 블럭의 Status 멤버를 NDIS_STATUS_RESOURCES로 설정할 수 있다. 이것은 또한 NDIS에게 그러한 패킷 디스크립터에 의해 지정된 네트워크 패킷 헤더와 데이터로 그리고 인디케이트된 패킷 배열에서 모든 연속적인 디스크립터들에 지정된 수신된 네트워크 패킷들로 바인드된 프로토콜들의 ProtocolReceive 함수들을 호출하도록 한다. 각 ProtocolReceive 함수는 주어진 패킷 헤더와 데이터를 조사하고 각각 선택적으로 인디케이트된 네트워크 패킷 데이터를 복사한다.

만약 아래 미니포트는 인디케이트한 수신들로 대역외 정보를 제공한다면, ProtocolReceive 함수는 각 그러한 패킷을 위해 대역외 정보를 검색하기 위해 NdisGetReceivedPacket NDIS_GET_ORIGINAL_PACKET을 호출할 수 있다. 그러한 아래 미니포트는 항상 full-packet 수신들을 인디케이트하기 때문에, ProtocolReceive 함수는 결코 NdisMIndicateReceivePacket 함수로 인디케이트된 패킷을 위해 NdisTransferData 함수를 호출하지 않을 것이다.

NDIS는 NdisM..IndicateReceive 혹은 NdisMIndicateReceivePacket 함수에 대한 호출들이 발생하는 것 처럼 계속해서 ProtocolReceive 함수들을 호출하지만, 분리된 호출들을 사용하여 바인드된 프로토콜들에 패킷을 인디케이트할 수 있다. 그러나 모든 프로토콜은 NDIS 혹은 아래 NIC 미니포트가 패킷들이 전송되는 네트워크을 걸쳐 어떤 제어를 가지지 않았을 있기 때문에 순서화되지 않은 수신된 패킷들을 다룰 수 있게 해야 한다.

드라이버 개발자는 프로토콜이 필터 특정 NdisM..IndicateReceive 함수들을 호출하는 아래 드라이버들로부터 추가적인 들어오는 패킷들을 잃지 않기 위해 ProtocolReceive 함수에서 보내는 시간을 최소화해야 한다. ProtocolReceive 함수는 들어오는 패킷을 거절해야 하거나 빠르게 클라이언트에 대해 관심이 있는 것처럼 패킷을 인식해야 한다. 만약 패킷을 수락한다면, ProtocolReceive 함수는 빠르게 패킷 데이터를 놓을 장소를 발견해야 하고 데이터를 복사해야 한다. ProtocolReceive 함수가 리턴하자마자, 시간 제한이 심각하지 않았을 때, 한번 혹은 그 이상의 NdisM..IndicateReceive 함수로 인디케이션들을 하는 어떤 아래 미니포트는 응답하는 NdisM..IndicateReceiveComplete 함수를 호출할 것이다. 프로토콜 드라이버의 ProtocolReceiveComplete 함수는 그리고나서 원래 인디케이션들을 위한 어떤 필요한 전처리를 행한다.

아래 드라이버는 NIC에서 수신된 패킷 데이터로부터 어떤 헤더들과 트레일러들을 제거하지 않거나 어떤 수신된 패딩을 제거하지 않는다. 다른 말로, 패킷은 데이터의 패딩과 프로토콜들에 인디케이트된 길이를 포함할 수 있다. ProtocolReceive 함수는 그러한 패딩을 감지하고 무시할 책임이 있다.

ProtocolReceive 함수에 전달된 HeaderBuffer와 LookAheadBuffer 인 버퍼들은 읽기 전용이고 단지 ProtocolReceive 함수가 제어를 리턴하기 전까지만 유효하다. ProtocolReceive 함수는 드라이버가 프로토콜 할당 저장공간에 필요한 모든 인디케이트된 데이터를 복사해야 한다. 윈도우즈 이천 프로토콜은 직접 인디케이션을 복사할 수 있는지는 OID_GEN_MAC_OPTIONS 쿼리를 위해 리턴된 NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA 플래그에 의존한다. 만약 이러한 플래그가 설정된다면, ProtocolReceive 함수는 자신의 저장 공간에 인디케이트된 데이터를 복사하기 위해 NdisMoveMemory 함수를 사용할 수 있다. 그렇지 않으면, TdiCopyLookaheadData 함수를 사용해야 한다. 그러나, 윈도우즈 이천 프로토콜은 만약 아래 드라이버가 NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA 플래그를 설정한다면 TdiCopyLookaheadData 함수를 호출할 수 있다.

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