NdisMCoIndicateReceivePacket

VOID NdisMCoIndicateReceivePacket( IN NDIS_HANDLE NdisVcHandle, IN PPNDIS_PACKET PacketArray, IN UINT NumberOfPackets );

NdisMCoIndicateReceivePacket은 NDIS가 VC에 대한 패킷들의 배열은 적당한 클라이언트 혹은 콜 매니저에게 포워드하기 위해 이용될 수 있다는 것을 알린다.

매개변수

NdisVcHandle

VC를 나타내는 핸들을 지정한다. NIC 드라이버는 원래 클라이언트가 나타는 호출을 설정할 때 혹은 콜 매니저가 들어오는 호출의 주지들을 나타내기 위해 클라이언트 등록 SAP를 위해 VC를 만들 때 MiniportCoCreateVc 함수에 대한 입력 매개변수로서 이 핸들을 얻는다.

PacketArray

수신된 데이터를 지정하기 위해 호출자에 의해 설립된 각 디스크립터로 패킷 디스크립터 배열 포인터들을 가리킨다.

NumberOfPackets

얼마나 많은 포인터들이 PacketArray에 배열내에 있는 지를 지정한다. 이 값은 적어도 1이 될 것이다.

주석

NdisMCoIndicateReceivePacket에 대한 호출은 NDIS는 연결 지향 NIC 드라이버로 주어진 NdisVcHandle를 공유하는 클라이언트 혹은 콜 매니저의 ProtocolCoReceivePacket 함수를 호출하도록 한다. 연결 지향 NIC 드라이버가 멀티패킷 혹은 하나의 패킷 리시브 인디케이션들로 만드는 지는 실행 종속이다. 그러나, 멀티 패킷 인디케이션들은 더 좋은 퍼포먼스를 낳을 수 있다.

NdisMCoIndicateReceivePacket를 호출하기 전에, 미니포트는 다음과 같이 패킷 배열을 설정해야 한다.

• PacketArray의 각 요소는 호출자가 NdisAllocatePacket함수로 패킷 pool로부터 할당되는 패킷 디스크립터에 대한 포인터이다.
• 그러한 패킷 디스크립터에 연결된 모든 버퍼 디스크립터들은 NdisAllocateBuffer로 버퍼 pool로부터 할당 되어진다. 미니포트는 버퍼 디스크립터가 단지 인디케이션을 위해 수신된 데이터를 맵하기 위해 리시브 버퍼의 풀 범위보다 작게 수신된 데이터를 포함하는 NIC의 리시브 버퍼를 맵핑하는 어떤 버퍼 디스크립터로 NdisAdjustBufferLength를 호출해야 한다. (NIC 드라이버는 마찬가지로, 그러한 버퍼 디스크립터의 소유권을 다시 얻을 때 NdisAdjustBufferLength로 맵핑을 재조정해야 한다.
• 만약 미니포트가 리시브들을 위한 타임 스탬프들을 인디케이트한다면은, NDIS_SET_PACKET_TIME_RECEIVED 와 혹은 NDIS_SET_PACKET_TIME_SENT 매크로들을 사용하여 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA내에 TimeReceived 혹은 TimeSent 멤버들을 설정해야 한다. 특정 배열의 모든 패킷들을 위해 리시브 타임스탬프로서 설정된 값을 즉시 얻기 위해 NdisGetCurrentSystemTime을 호출할 수 있다.
• 아웃오브밴드 데이터 블럭내에 HeaderSize는 연결 지향 미디엄을 위해 각 수신 패킷의 헤더 크기와 일치해야 한다.
• 만약 드라이버는 리시브들을 위해 어떤 추가적인 아웃오브밴드 정보를 인디케이트한다면은, OOB 블럭내에 MediaSpecificInformation에서 호출자 할당 버퍼내에 제공된 정보의 바이트 수로 SizeMediaSpecificInfo를 설정해야 한다. 미니포트는 이러한 값들을 설정하기 위해 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO 매크로를 사용할 수 있다. 그렇지 않다면은, SizeMediaSpecificInfo는 0이 될 것이고, MediaSpecificInformation은 NULL이 될 것이다.
• 미니포트는 만약 패킷 디스크립터들과 특정 인디케이션 내에 몇몇 패킷들을 위한 관련된 버퍼 디스크립터들의 소유권을 얻을 필요가 있다면은 아웃 오브 밴드 데이터 블럭의 Status 멤버를 NDIS_STATUS_RESOURCES로 설정할 수 있다.

  NDIS_STATUS_RESOURCES를 셋팅하는 것은 NDIS가 클라이언트 혹은 콜 매니저가 미니포트에게 패킷 데이터를 복사하게 하고 각 패킷 디스크립터(관련된 버퍼들)들을 해제하도록 함으로써 NdisVcHandle을 공유하는 프로토콜에게 한번에 한번 각 그러한 패킷 디스크립터를 인디케이트하도록 한다. 그렇지 않으면은 NdisMCoIndicateReceivePacket에 대한 호출은 프로토콜에게 패킷 디스크립터가 미니포트의 MiniportReturnPacket 함수에게 리턴될 때까지 각 패킷 디스크립터에 연결된 버퍼들에 대한 배타적이고, 읽기 전용 접근을 제공한다.

• 만약 미니포트가 패킷 디스크립터를 윗계층으로 인디케이트하기 전에, 패킷의 Status를 NDIS_STATUS_SUCCESS로 설정한다면은, 패킷의 Status은 항상 NdisMCoIndicateReceivePacket이 리턴하자마자 항상 NDIS_STATUS_PENDING이 된다. NDIS가 계속적으로 미니포트의 MiniportReturnPacket 함수에 대한 패킷 디스크립터를 패킷의 상태를 NDIS_STATUS_SUCCESS 로 설정해서 리턴한다.
• 만약 미니포트가 패킷 디스크립터를 윗 계층에 인디케이딩하기전에, 패킷의 Status를 설정한다면은 패킷의 Status는 항상 NdisMCoIndicateReceivePacket이 리턴하자마자 NDIS_STATUS_SUCCESS이다.

MiniportHandleInterrupt 함수로부터 NdisMCoIndicateReceivePacket에 대한 몇몇 미니포트 결정 만큼의 호출 후에 미니포트는 NdisMCoReceiveComplete를 호출해야 한다.

만약 프로토콜이 충분히 즉시 리시브 인디케이션을 위해 미니포트 할당 자원들을 리턴하지 않는다면은, NIC 드라이버는 NIC 드라이버가 연속적인 리시브 인디케이션들을 위해 이용할 수 있는 패킷 혹은 버퍼 디스크립터들(혹은 심지어 NIC에서 리시브 버퍼 공간)에서 낮게 실행할 수 있는 규칙을 어기는 프로토콜에게 경고하기 위해 NdisMCoIndicateStatus에 NDIS_STATUS_RESOURCES로 호출할 수 있다.

NdisMCoIndicateReceivePacket의 호출자들은 IRQL DISPATCH_LEVEL에서 실행할 수 있다. 그러나, NIC 드라이버가 일반적으로 항상 IRQL DISPATCH_LEVEL에서 실행하는 MiniportHandleInterrupt 함수로부터 이 호출을 한다.