NDIS_SET_PACKET_STATUS

NDIS_SET_PACKET_STATUS(

  IN PNDIS_PACKET  Packet,

    IN NDIS_STATUS  Status

    );

NDIS_SET_PACKET_STATUS 함수는 드라이버가 NdisMIndicateReceivePacket 함수를 호출하기 전에 혹은 드라이버의 MiniportSendPackets 함수가 제어를 리턴하기 전에 주어진 패킷 디스크립터와 관련된 out-of-band 데이터 블럭에서 Status 값을 설정한다.

매개변수

Packet
수신 인디케이션을 위한 호출자에 의해 혹은 보내기를 위한 프로토콜에 의해 할당된 패킷 디스크립터를 가리킨다.

Status
설정된 상태를 지정한다.

수신 인디케이션들에서 사용된 패킷 디스크립터를 위해, 값은 다음과 같은 값이 될 수 있다. :

NDIS_STATUS_SUCCESS
드라이버는 패킷 디스크립터가 MiniportReturnPacket 함수로 리턴될 때까지 NdisMIndicateReceivePacket 함수로 막 인디케이트되는 패킷의 소유권을 양도한다.

인디케이션을 수신하는 프로토콜들은 패킷에 제공된 어떤 out-of-band 정보와 패킷 디스크립터와 체인된 버퍼 디스크립터들에 의해 맵된 모든 버퍼들과 함께 가능한한 관심있는 클라이언트들에게 처리된 복사복을 포워드하면서 인디케이트된 net 패킷 데이터를 복사하기 위해 패킷 디스크립터를 사용할 수 있다.

NDIS_STATUS_RESOURCES
드라이버는 NdisMIndicateReceivePacket 함수로 인디케이트된 패킷과 패킷 배열내에서 모든 연속된 패킷들의 소유권을 유지한다. 모든 이러한 패킷들은 바운드된 프로토콜들의 ProtocolReceive 함수들에 대해 한번에 한번 인디케이트될 것이다.

이러한 상태를 설정하는 것은 각 패킷 디스크립터의 더 빠르게 인디케이트하는 드라이버에게 체인화된 버퍼 디스크립터들에 의해 메모리 맵된 각 패킷 디스크립터를 위한 out-of-band 데이터 블럭내에 어떤 미디엄 특정 버퍼의 각각 그러한 패킷 디스크립터의 소유권을 바운드된 프로토콜들이 리턴하도록 한다. 프로토콜들은 그들이 인디케이션으로부터 복사되는 데이터를 후처리하고 그들의 클라이언트들에게 처리된 데이터를 포워드를 시작하기 위해 ProtocolReceiveComplete 함수들에 대한 호출을 위해 기다려야 한다.

인디케이션하는 드라이버는 만약 패킷 pool 혹은 버퍼 pool이 작은 곳에서 실행한다면은 이러한 상태를 설정할 수 있다. 인디케이션하는 NIC 드라이버는 항상 만약 높은 네트워크 트래픽때문에 NIC 수신 버퍼들보다 낮은 곳에서 실행한다면은 항상 이 상태를 설정한다. 버스마스터 DMA NIC 드라이버는 추가적인 NIC 수신 버퍼 공간을 얻기 위해 이러한 환경에서 NdisMAllocateSharedMemoryAsync 함수를 호출할 것이다.

NDIS는 만약 이러한 상태가 인디케이트된 배열내에 패킷을 위해 설정된다면은, 그러한 배열에서 모든 연속적인 패킷들을 위해 설정된다는 것을 추측한다. 결과적으로, 인디케이션되는 드라이버는 하나의 패킷 디스크립터를 위해 out-of-band 데이터 블럭내에서 이러한 상태를 설정한 후에 배열 내에서 연속된 패킷 디스크립터를 위한 상태를 설정할 필요가 없다.

보내기들을 위해 사용된 패킷 디스크립터들을 위해, MiniportSendPackets 함수는 다음과 같은 값들의 하나를 설정할 수 있다.

NDIS_STATUS_PENDING
드라이버는 비동기적으로 요구된 보내기 연산을 완성할 것이다.

MiniportSendPackets 함수가 제어를 리턴한 후에, 드라이버는 NDIS가 패킷 디스크립터에 의해 지정된 자원들을 할당하고 보내기를 초기화한 드라이버의 ProtocolSendComplete 함수에 전달하는(propagate) 주어진 패킷 디스크립터를 위한 마지막 완성 상태로 NdisMSendComplete 함수를 호출할 것이다.

NDIS_STATUS_RESOURCES
드라이버는 현 자원 제한때문에 주어진 패킷 배열내에 지정된 모든 보내기들을 처리할 수 없다.

NDIS는 MiniportSendPackets에 주어진 배열내에 모든 연속된 패킷 디스크립터들을 위한 Status 멤버가 같은 값으로 설정된다고 추측한다. NDIS는 드라이버가 처음 호출이 발생할 수 있는 것이 NdisMSendResourcesAvailable 함수 혹은 NdisMSendComplete 함수를 호출할 때 MiniportSendPackets 함수에 대한 재제출을 위해 같은 순서로 내부적으로 이러한 패킷 디스크립터들을 큐에 저장한다. NDIS는 이러한 미니포트 설정 상태 값을 NDIS_STATUS_PENDING으로 프로토콜들에게 반영한다.

NDIS_STATUS_XXX
MiniportSendPackets 함수는 제어를 리턴하기 전에 주어진 보내기 요구를 완성하고 있다.

그러한 보내기 패킷은 NDIS_STATUS_SUCCESS로 완성하거나 드라이버 결정 에러 상태로 완성된다면은, MiniportSendPackets 함수들은 주어진 패킷 디스크립터를 위해 Status 멤버를 설정해야 하고 그래서 NDIS는 NDIS가 리턴된 패킷 디스크립터로 ProtocolSendComplete 함수를 호출할 때 보내기를 초기화하는 프로토콜에게 되돌려주는 이러한 생타를 반영할 수 있다.

주석

바운드된 프로토콜들에 대한 NdisMIndicateReceivePacket 함수로 수신들을 인디케이트하는 드라이버들과 혹은 MiniportSendPackets 함수들을 가지는 드라이버들은 NDIS_SET_PACKET_STATUS 매크로를 사용한다.

그러한 아래 드라이버가 배열내에 몇몇 수의 패킷 디스크립터들의 Status 값을 설정한 후 이러한 패킷 디스크립터들의 배열로 NdisMIndicateReceivePacket 함수을 호출한 후에 NdisMIndicateReceivePacket 함수가 제어를 리턴할 때 NDIS_GET_PACKET_STATUS 매크로를 사용해야 한다. 드라이버가 NDIS_STATUS_SUCCESS로 초기화된 각 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA 블럭내에 리턴된 상태값은 인디케이트하는 드라이버가 다음에 하는 것을 결정한다. 다음과 같은 값이다.

NDIS_STATUS_SUCCESS
만약 이것이 NdisMIndicateReceivePacket 함수에 대한 미니포트의 호출로부터 리턴하자마자 설정된다면은, 미니포트는 다음과 같은 소유권을 다시 얻는다:

  • 패킷 디스크립터

  • 패킷 디스크립터와 관련된 관련된 out-of-band 데이버 블럭과 이러한 블럭과 관련된 어떤 미디어 특정 정보 버퍼

  • 패킷 디스크립터에 체인된 버퍼 디스크립터들에 의해 맵된 모든 버퍼들

NDIS_STATUS_PENDING
만약 이것이 NdisMIndicateReceivePacket 함수로부터 리턴하자마자 설정된다면은, 프로토콜들은 관련된 out-of-band 데이터 블럭의 그리고 이러한 블럭내에 지정된 어떤 버퍼의 패킷 디스크립터가 인디케이트하는 드라이버의 MiniportReturnPacket 함수에 리턴될 때까지 패킷 디스크립터에 체인된 버퍼 디스크립터에 맵된 모든 버퍼들의 소유권을 유지한다. 그러나, 프로토콜들은 이러한 미니포트 할당 자원들에 대한 읽기 전용 접근이 주어진다.

MiniportSendPackets 함수는 NDIS_STATUS_PENDING 혹은 NDIS_STATUS_RESOURCES와 다른 어떤 것으로 들어오는 보내기 패킷을 위해 Status 값을 설정한다면은, 패킷을 완성하고 관련된 패킷 디스크립터에 의해 지정된 모든 자원들에 대한 소유권을 양도한다. NDIS는 패킷 디스크립터를 할당한 드라이버의 ProtocolSendComplete 함수에 리턴하고 입력 매개변수로서 미니포트 설정 상태 값을 ProtocolSendComplete 함수에 전달한다.(propagate) 그렇지 않는다면은, 아래 드라이버는 패킷 디스크립터로 혹은 비동기 보내기 연산이 행해질 때 마지막 상태로 NdisMSendComplete 함수를 호출할 것이다.

프로토콜 드라이버들은 NdisSendPackets 함수 혹은 NdisSend 함수로부터 리턴하자 마자 관련된 out-of-band 데이터 블럭내에 Status 값을 테스트할 필요가 없다. NDIS 혹은 아래 드라이버는 패킷 디스크립터, 관련된 out-of-band 블럭, 이 블럭내에 지정된 어떤 버퍼들, ProtocolSendComplete 함수가 패킷 디스크립터로 호출될 때까지 패킷 디스크립터에 체인된 버퍼 디스크립터들에 의해 맵된 모든 버퍼들의 소유권을 보유한다.

NDIS_SET_PACKET_STATUS의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행한다.