NdisMIndicateReceivePacket

VOID

  NdisMIndicateReceivePacket(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN PPNDIS_PACKET  ReceivePackets,

    IN UINT  NumberOfPackets

    );

NdisMIndicateReceivePacket은 NDIS에게 수신된 패킷들의 배열이 적당한 바인드된 프로토콜 드라이버들에게 포워드 되기위해 이용할 수 있다는 것을 알린다.

매개변수

MiniportAdapterHandle
MiniportInitialize에 대한 입력 핸들을 지정한다.

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

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

주석

버스마스터 DMA NIC들의 드라이버들은 NdisMIndicateReceivePacket으로 멀티패킷 수신 인디케이션들을 만듦으로써 퍼포먼스에 상당한 이드륵을 보여줄 것이다. 그러나, 패킷 우선권, 타임스탬프들과 같은 수신 패킷들의 out-of-band 데이터를 가리키는 드라이버들은 항상 하나의 패킷으로 이 함수를 또한 호출할 수 있다.

미니포트 드라이버가 NdisMIndicateReceivePacket을 호출할 때, NDIS는 다르게 ReceivePackets에 미니포트 결정 순서로 이 함수를 익스포트하는 바운드된 프로토콜 드라이버의 ProtocolReceivePacket 함수에 다르게 각 포인터를 전달한다. 다른 바운드된 프로토콜들에게, NDIS는 각 패킷 포인터를 ProtocolReceive 함수들을 전달한다.

만약 미니포트 드라이버가 시스템이 OID_GEN_MEDIA_IN_USE 쿼리에 대한 응답으로 필터 패키지를 제공하는 타입으로 NIC 미디엄을 할당하지 않는다면은, NDIS는 ProtocolReceivePackets을 익스포트하는 모든 바인드된 프로토콜 드라이버들에게 드라이버의 수신 인디케이션들을 포워드한다. 그렇지 않는다면은, NDIS는 자동적으로, 미니포트 드라이버의 수신 인디케이션들에게 적당한 필터 라이브러리를 적용한다.

NdisMIndicateReceivePacket의 어떤 호출자는 다음과 같은 패킷 배열을 처음 설정해야 한다.

  • 각 요소는 호출자가 패킷 pool로부터 할당해야 하는 패킷 디스크립터에 대한 포인터이다. 각 패킷 디스크립터는 적어도 PotocolReserved 섹션이 16바이트를 가지고 있어야 한다.

  • 그러한 패킷 디스크립터내에 연결된 모든 버퍼 디스크립터들은 버퍼 pool로부터 할당되어져야 한다. 미니포트 드라이버는 버퍼 디스크립터는 단지 인디케이션을 위해 수신된 데이터를 맵하기 위해 수신 버퍼의 full 범위보다 작은 수신된 데이터를 포함하는 NIC에 수신 버퍼를 맵핑하는 어떤 버퍼 디스크립터로 NdisAdjustBufferLength를 호출해야 한다. (NIC 드라이버는 마찬가지로, 그러한 버퍼 디스크립터의 소유권을 다시 얻기 위해 NdisAdjustBufferLength로 맵핑을 재조정해야 한다.)

  • 만약 미니포트 드라이버가 수신된 패킷들을 위한 타임스탬프들을 인디케이트한다면은, NDIS_SET_PACKET_TME_RECEIVED와 NDIS_SET_PACKET_TIME_SENT 매크로를 사용하여 패킷 디스크립터들과 관련된 NDIS_PACKET_OOB_DATA 내에 TimeReceived 와 TimeSent 멤버들을 설정해야 한다. 일단 특정 패킷 배열의 모든 패킷들을 위해 수신 타임스탬프를 설정하기 위해 NdisGetCurrentSystemTime을 호출할 수 있다.

  • out-of-band 블럭내에 HeaderSize는 미디엄을 위해 각 수신된 패킷의 헤더 크기와 일치해야 한다. 예를 들어, 원하는 미디엄으로 Ethernet을 선택하는 드라이버는 패킷 디스크립터를 할당할 때 NDIS_PACKET_OOB_DATA 블럭의 HeaderSize를 14로 초기화 한다. 드라이버는 HeaderSize를 설정하기 위해 NDIS_SET_PACKET_HEADER_SIZE 매크로를 사용해야 한다.

  • 만약 드라이버가 수신들로 추가적인 out-of-band 정보를 인디케이트한다면은, MediaSpecificInformation에 호출자 할당 버퍼내에 제공된 수 바이트의 정보로 SizeMediaSpecificInfo를 설정해야 한다.

  • 미니포트 드라이버는 이러한 값들을 설정하기 위해 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO를 사용할 수 있다. 그렇지 않는다면은, SizeMediaSpecificInfo를 0으로 설정될 것이고, MediaSpecficInformation은 NULL로 될 것이다.

  • 미니포트 드라이버는 만약 특정 인디케이션내에서 몇몇 요소의 버퍼 디스크립터들과 패킷 디스크립터의 소유권을 유지할 필요가 있다면은 out-of-band 데이터 블럭의 Status 멤버를 NDIS_STATUS_RESOURCES로 설정할 수 있다. NDIS_STATUS_RESOURCES로 설정하는 것은 NDIS에게 각 프로토콜에게 패킷 데이터를 복사하도록 하고 미니포트에게 다시 리턴되어지는 각 패킷을 해제하도록 함으로써 바인드된 프로토콜의 ProtocolReceive 함수들에게 한번에 한번 각 그러한 패킷을 인디케이트하도록 한다.

  • 비직렬화된 미니포트 드라이버는 패킷 디스크립터를 위로 인디케이트하기 전에 지역 변수에 out-of-band 데이터 블럭의 Status 멤버에 설정할 수 있따. 아래 더 자세한 설명을 있는 것처럼, NdisMIndicateReceivePacket을 리턴할 때, 비직렬화된 미니포트 드라이버는 즉시 패킷 디스크립터와 관련된 버퍼들을 재요구할 수 있는지를 결정하기 위해 저장된 패킷의 Status을 체크해야 한다.

만약 직렬화된 미니포트 드라이버가 NDIS_STATUS_RESOURCES로 패킷의 Status 멤버를 설정하지 않는다면은 NdisMIndicateReceivePacket에 대한 호출은 관심있는 프로토콜들의 배타적이고 읽기 전용의 각 패킷에 연결된 버퍼들에 대한 접근을 제공한다. 미니포트 드라이버는 다음과 같이 패킷 디스크립터와 관련된 버퍼들의 소유권을 다시 얻는다.

  • 만약 out-of-band 데이터 블럭내에 Status이 NdisMIndicateReceivePacket으로부터 리턴된 값이 NDIS_STATUS_SUCCESS로 설정된다면은, 미니포트 드라이버는 즉시 패킷에 연결된 패킷 디스크립터와 모든 버퍼들의 소유권을 다시 얻는다. 연속적인 수신 인디케이션들에서 재사용을 위해 이러한 디스크립터들을 준비할 수 있다.

  • 만약 Status가 NdisMIndicateReceivePacket으로부터 리턴값이 NDIS_STATUS_PENDING으로 설정된다면은, 미니포트 드라이버는 NDIS가 계속해서 미니포트 드라이버의 MiniportReturnPacket 함수를 호출할 때 패킷에 연결된 패킷 디스크립터와 모든 버퍼들의 소유권을 다시 얻는다. 그리고나서 계속적인 수신 인디케이션들에서 재사용을 위해 이러한 디스크립터들을 준비할 수 있다.

직렬화된 미니포트 드라이버는 NdisMIndicateReceivePacket이 제어를 리턴하 때 인디케이트된 패킷들의 소유권을 얻는 것을 결정하기 위해 NDIS_GET_PACKET_STATUS를 사용해야 한다.

비직렬화된 미니포트 드라이버는 NdisMIndicateReceivePacket의 리턴으로 인디케이트된 패킷들의 Status를 조사할 필요가 없다. 그 대신에, 직렬화된 미니포트 드라이버는 패킷 디스크립터를 위로 인디케이트하기 전에 지역 변수에 패킷의 Status 값을 저장해야 한다. NdisMIndicateReceivePacket을 리턴할 때, 미니포트 드라이버는 저장된 패킷의 Status를 체크해야 한다. 만약 미니포트 드라이버가 패킷의 Status를 패킷 디스크립터를 위로 인디케이트하기 전에 NDIS_STATUS_RESOURCES로 설정한다면은, 자신의 MiniportReturnPacket를 호출함으로써 NdisMIndicateReceivePacket를 리턴한 후에 즉시 패킷 디스크립터를 재주장해야 한다. 이러한 경우에, NDIS는 패킷 디스크립터를 리턴하기 위해 미니포트 드라이버의 MiniportReturnPacket 함수를 호출하지 않는다. 만약 미니포트 드라이버가 패킷 디스크립터를 위로 인디케이트하기 전에 패킷의 Status를 NDIS_STATUS_SUCCESS로 설정한다면은 미니포트 드라이버는 NDIS가 계속해서 패킷 디스크립터를 미니포트 드라이버의 MiniportReturnPacket 함수에 리턴할 때까지패킷 디스크립터를 재요구할 필요가 없다.

미니포트 드라이버가 인디케이트된 패킷의 디스크립터의 소유권을 다시 얻는다면은, NdisZeroMemory로 NDIS_OOB_DATA_FROM_PACKET에 의해 리턴된 포인터를 전달함으로써 재사용을 위해 관련된 out-of-band 데이터 블럭을 준비할 수 있다. 대체로, 미니포트 드라이버는 간단히 NDIS_SET_PACKET_XXX 매크로들로 혹은 NDIS_OOB_DATA_FROM_PACKET에 의해 리턴된 포인터로 계속적인 수신에서 관련된 멤버들을 리셋할 수 있다.

미니포트 드라이버는 NdisZeroMemory로 패킷 디스크립터 포인터를 전달할 필요가 없다. 이러한 하는 동안 계속적인 인디케이션들을 위해 재사용할 수 없도록 함으로써 패킷 디스크립터를 파괴한다. 관련된 out-of-band 데이터를 클리어하기 위해, 드라이버는 NDIS_OOB_DATA_FROM_PACKET에 의해 리턴된 포인터를 전달해야 한다.

NdisMIndicareReceivePacket에게 전달된 패킷 배열들은 NDIS 라이브러리의 수신 인디케이션 코드 경오내에 페이지 아웃(page out)될 수 없는 스택에 할당되어질 수 있다.

NDIS가 ProtocolReceivePacket 함수를 익스포트하는 드라이버의 ProtocolReceive 함수를 호출할 때, ProtocolReceive 함수는 패킷 배열의 부분으로 인디케이트되는 들어오는 패킷과 관련된 out-of-band 정보를 검색하기 위해 NDIS_GET_ORIGINAL_PACKET과 NdisGetReceivePacket을 호출할 수 있다.

NdisMIndicateReceivePacket를 호출하는 어떤 미니포트 드라이버는 full 패킷들을 인디케이트해야 한다. 결과적으로, 그러한 드라이버는 MiniportTransferData함수를 가지지 않는다.

NdisMIndicateReceivePacket의 직렬화된 호출자들은 IRQL DISPATCH_LEVEL에서 실행해야한다. 직렬화된 NdisMIndicateReceivePacket의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행할 수 있다.