NdisMArcIndicateReceive

VOID 

  NdisMArcIndicateReceive(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN PUCHAR  HeaderBuffer,

    IN PUCHAR  DataBuffer,

    IN UINT  Length

    );

NdisMArcIndicateReceive함수는 NDIS에게 ARCNET패킷(혹은 몇몇 패킷의 처음 룩어헤드 위치)이 도착해서 NDIS가 받은 패킷을 바인딩된 프로토콜들에게 포워드 할수 있음을 알린다.

매개변수

MiniportAdapterHandle
MiniportInitialize함수에게 처음으로 입력되는 핸들을 지정한다.

HeaderBuffer
패킷 헤더의 베이스 가상주소를 지정한다. 헤더 버퍼는 프로토콜ID를 앞서는 모든 바이트를 포함한다.

DataBuffer
수신된 패킷 데이타의 Length바이트들을 포함하는 버퍼의 가상 베이스 주소를 지정한다.

Length
DataBuffer에 버퍼내의 바이트 수를 지정한다.

주석

만약 직렬화된 미니포트가 닉을 NdisMediumArcnet878_3타입으로써 혹은 OID_GEN_MEDIA_IN_USE쿼리에대한 응답으로 NdisMediumArcnetRaw로써 설명한다면, 만약 드라이버가 멀티 패킷을 수신을 지원하지 않는다면, 직렬화된 미니포트는 NdisMArcIndicateReceive함수를 호출한다. 멀티패킷수신을 지원하는 어떤 미니포트는 미디엄 타입 지정 NdisM..IndicateReceive함수들을 호출하기보다는 패킷 배열로 NdisMIndicateReceivePacket함수를 호출한다.

미니포트가 NdisMArcIndicateReceive함수를 호출할때, NDIS는 패킷헤더의 포인터와 패킷내의 데이타의 몇몇 혹은 모든 포인터를 바인딩된 프로토콜 드라이버(들)의 ProtocolReceive함수(들)에게 넘긴다. 인디케이트를 받은 각 프로토콜은 다음과 같이 할수 있다.:

  1. 인디케이션이 프로토콜 클라이언트에게 흥미가 있는지를 결정하기위해 패킷내의 헤더와 데이타를 조사한다.

  2. 만약 그렇다면, 헤더혹은 데이타만큼의 카피는 NdisMoveMemory함수를 사용하여 프로토콜 할당의 메모리에서 볼수 있다.

  3. 충분히 체인화된 버퍼 디스크립터들로 패킷 디스크립터를 할당함에의해 그리고 NdisTransferData데이타를 호출함에의해 남아있는 데이타가 있다면 얻어온다. NdisTransferData함수의 호출은 데이타를 프로토콜 제공 패킷으로 카피하기위해 닉 드라이버의 MiniportTransferData함수를 호출하도록 한다.

NdisMArcIndicateReceive함수를 통한 인디케이트를 받는 어떤 프로토콜 드라이버에대해서, HeaderBuffer와 DataBuffer주소들은 ProtocolReceive함수에대한 현재 호출동안에만 유효하다. 그리고 이러한 버퍼들은 읽기전용이다. 프로토콜 드라이버는 이러한 관계된 버퍼들로 인디케이트된 패킷에대한 포인터를 얻을수 없을뿐더러 차후 사용을 위한 이러한 버퍼들의 포인터를 얻을수 없다. 프로토콜 드라이버가 그런 패킷으로부터 필요로하는 어떤 데이타는 수신 인디케이트동안에 카피되고 복사되어야만 한다.

헤더내의 데이타는 닉에서 수신된 것과 같다. 미니포트는 닉이 수신한 데이타로부터 어떤 헤더들 혹은 트레일러들을 제거할 필요가 없다.

전송 드라이버는 미디엄의 요구에대해 너무 작은 어떤 패킷에대한 패딩을 추가한다. 수신하는 미니포트는 데이타내에 그런 패딩을 포함할수 있고 그 후에 인디케이트하는 길이를 포함할수 있다. 각 바인딩된 프로토콜은 어떤 그런 패딩을 검사하고 그것을 무시하는 책임이 있다.

단지 직력화된 미니포트들만이 NdisMArcIndicateReceive함수를 호출할수 있음을 기억하라.

NdisMArcIndicateReceive함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작한다.