NdisMTrIndicateReceive

VOID 

  NdisMTrIndicateReceive(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN NDIS_HANDLE  MiniportReceiveContext,

    IN PVOID  HeaderBuffer,

    IN UINT  HeaderBufferSize,

    IN PVOID  LookaheadBuffer,

    IN UINT  LookaheadBufferSize,

    IN UINT  PacketSize

    );

NdisMTrIndicateReceive는 NDIS에게 토큰링패킷(혹은 패킷의 몇몇 초기룩어헤드부분)이 도착했다는것을 알려준다. 그래서 NDIS는 패킷을 바인딩된 프로토콜들에게 포워드한다.

매개변수

MiniportAdapterHandle
MiniportInitialize에서 넣어준 원래 핸들을 말한다.

MiniportReceiveContext
호출자가 제공하는 컨텍스트핸들을 말한다. NDIS는 MiniportTransferData함수에게 이 파라미터를 넣어줌으로써 이핸들을 리턴한다, 만약 그것이 호출된다면. 미니포트는 패킷이 받아지고 있다는것을 결정하기위해 이핸들에의해 설계된 컨텍스트 영역을 사용할 수 있다.

HeaderBuffer
버퍼화된 패킷헤더의 베이스가상주소를 말한다.

HeaderBufferSize
패킷헤더의 바이트사이즈를 말한다.

LookaheadBuffer
패킷에서 데이타의 처음 LookaheadBufferSize의 바이트를 포함하는 버퍼의 베이스 가상주소를 말한다.

LookaheadBufferSize
룩어헤드버퍼의 바이트사이즈를 말한다. 이값은 적어도 MiniportSetInformation이 OID_GEN_CURRENT_LOOKAHEAD로 호출될때 설정해준 룩어헤드버퍼사이즈보다 크다. 패킷이 작다면 패킷만큼 크다. 패킷이 룩어헤드버퍼사이즈보다 작다면, 룩어헤드버퍼는 전체프레임을 포함한다.

만약 충분한 받은데이타가 닉에서 이용될 수 있다면, 미니포트는 LookaheadBufferSize를 최소로 요구되어지는 것보다 크게 설정할수 있다.

PacketSize
받은패킷데이타의 바이트사이즈를 말한다. 이 값은 HeaderBufferSize를 포함하지 않는다.

PacketSize가 LookaheadBufferSize보다 클때, 프로토콜 드라이버는 패킷안에 남아 있는 데이타를 전달하는 MiniportTransferData함수를 호출시키는 NdisTransferData를 호출한다.

주석

만약 닉이 OID_GEN_MEDIA_IN_USE쿼리에대한 응답으로 NdisMedium802_5 로 설계된다면,만약 미니포트가 NdisMIndicateReceivePacket으로 받았다는것을 인디케이트하지 않는다면, 미니포트는 NdisMTrIndicateReceive를 호출한다.

미니포트가 NdisMEthIndicateReceive를 호출할때, NDIS는 패킷헤더의 포인터와 패킷의 전부혹은 일부의 포인터를 바인딩된 프로토콜 드라이버(들)의 ProtocolReceive 함수(들)에게 넘길것이다. 인디케이션을 받은 각 프로토콜은 다음을 할수 있다.

  1. 인디케이션이 프로토콜의 클라이언트(들)에게 관심을 끄는것인지 아니지를 결정하기위해 패킷의 헤더와 데이타를 검사한다.

  2. 만약 그렇다면, 헤더와 데이타만큼의 카피는 프로토콜이 NdisMoveMemory로 할당한 메모리에서 볼수 있다.

  3. 남아있는데이타가 있다면 체인화된 충분한 버퍼디스크립터들로 패킷디스크립터를 할당하고, NdisTransferData를 호출로 인한 인디케이션에대해 남아있는데이타를 얻어온다.

NdisMTrIndicateReceive을 통한 인디케이트를 받은 어떤 프로토콜드라이버에대해서, HeaderBuffer와 LookaheadBuffer의 주소들은 ProtocolReceive함수에대한 현재 호출 동안에만 유효하고, 이런한 버퍼들은 읽기전용이다. 프로토콜드라이버는 이러한 관련된 버퍼들로 인디케이트된 패킷의 포인터를 소유할수 없고,나중에 사용하기위한 이러한 버퍼들의 포인터들을 소유할 수도 없다. 프로토콜드라이버가 그런패킷으로부터 요구하는 데이타는 리시브인디케이트하는동안 복사되고 저장되어야 한다.

헤더안의 데이타는 닉에서 받은 것과 같다. 미니포트는 닉에서 받은 데이타의 헤더들혹은 트레이러(자료의 맨마지막 부분)를 제거할 필요가 없다.

전송하는 드라이버는 미디엄의 요구에대해서 너무 짧은 패킷에게 패딩을 덧붙인다. 받는 미니포트는 나중에 인디케이트 하는 데이타와 length안에 그런 패딩을 포함할수 있다. 각 바인딩된 프로토콜은 그런 패딩을 탐지하고 무시한다.

NdisMTrIndicateReceive의 직렬화된 호출들은 IRQL DISPATCH_LEVEL에서 동작한다. NdisMTrIndicateReceive의 비직렬화된 호출들은 IRQL DISPATCH_LEVEL보다 낮은 레벨에서 동작한다.