NdisAllocatePacketPoolEx

VOID NdisAllocatePacketPoolEx( OUT PNDIS_STATUS Status, OUT PNDIS_HANDLE PoolHandle, IN UINT NumberOfDescriptors, IN UINT NumberOfOverflowDescriptors, IN UINT ProtocolReservedLength );

NdisAllocatePacketPoolEx는 패킷디스크립터의 풀에대한 저장블럭을 할당하고 초기화한다.

매개변수

Status

이함수는 패킷풀할당에대한 상태를 리턴하는 호출자제공변수의 포인터이고, 다음중 하나일수 있다.

NDIS_STATUS_SUCCESS

상위레벨드라이버로의 인디케이션을 만들기위한 패킷디스크립터가 필요할때, 혹은 하위레벨드라이버에게 패킷을 내려보기위한 패킷디스크립터가 필요할때 드라이버는 NdisAllocatePacket에대한 호출을 만들수 있다.

NDIS_STATUS_RESOURCES

메모리부족일 가능으로 패킷풀을 할당하기위한 시도가 실패했다. 이 리턴은 꼭 뒤이어 일어나는 호출이 실패한다는 것을 의미하지 않는다. 그러나 호출자는 NumberOfDescriptors를 줄이려는 시도를 할지 모르고 즉시 호출할지 모른다.

PoolHandle

이함수가 패킷풀에대한 핸들을 리턴할때의 호출자가 제공한 변수의 포인터. 이핸들은 드라이버가 나중에 호출하는 Ndis..Packet함수들에게 필요한 파라미터이다.

NumberOfDescriptors

풀이 예상된 보통의 사용에대해서 포함해야하는 패킷디스크립터의 수를 나타낸다. 할당되어질수 있는 최대NumberOfDescriptors 는 0xFFFF이다. 만약 시도가 이것보다 더많은 것을 할당하려한다면, NdisAllocatePacketPoolEx는 NDIS_STATUS_RESOURCES의 상태를 리턴할 것이다.

NumberOfOverflowDescriptors

예정된 오버플러우상황에대한 패킷디스크립터를의 수를 나타낸다(즉, NumberOfDescriptors에 의해 정해진 모든 디스크립터가 사용중일때). 만약 이파라미터와(NumberOfDescriptors ??) NumberOfOverflowDescriptors의 합이 0xFFFF를 넘는다면, NdisAllocatePacketPoolEx는 NumberOfDescriptors와 NumberOfOverflowDescriptors의 합이 0xFFFF가 되도록 하기위해서 이파라미터로써 제공된 값을 줄인다.

ProtocolReservedLength

각 패킷디스크립터의 ProtocolReserved배열에 대한 할당된 바이트의 수를 나타낸다. 리시브인디케이션에서 사용된 패킷디스크립터에 대해 이파라미터는 최대 16(바이트)일수 있다.

주석

NdisAllocatePacketPoolEx의 성공적인 호출은 패킷풀의 핸들을 리턴한다. 호출자는 저장해야만 한다. 일반적으로, 드라이버는 다음에 NdisAllocatePacket을 패킷디스크립터의 설정을 할당하기위해 이핸들로 한번 혹은 여러번 호출하다.

NdisAllocatePacketPoolEx은 NumberOfDescriptors에의해 설정된 패킷디스크립터의수를 수용하기위한 충분한 메모를 정적으로 할당한다. NdisAllocatePacket의 호출로 풀로부터 할당될 수 있는 패킷디스크립터의 총 수는 0xFFFF보다 작거나 혹은 NdisAllocatePacketPoolEx에 처음에 넘겨준 NumberOfDescriptors와 NumberOfOverflowDescriptors의 합보다 작다. 오버플로어디스크립터들은 오버플로어상황에서 동적으로 할당된다. - 즉, 주어진 NumberOfDescriptors가 이미 할당되고 여전히 사용중일때.

드라이버가 패킷풀에대해서 패킷디스크립터를 프리리스트에 리턴하기위해서 NdisFreePacket호출하기전에 NumberOfDescriptors 와 NumberOfOverflowDescriptors의 합은 드라이버가 NdisAllocatePacket를 얼마나 호출할수 있는지에 대한 실제적인 제한이다.

NdisAllocatePacketPoolEx의 호출자는 예상되는 보통의 로드에 대해서 요구되어지는 패킷디스크립터의 수로 NumberOfDescriptors를 설정해야만 한다. 드라이버는 예상되는 최대 피크로드를 수용하기위해 필요한 추가적인 디스크립터들의 수로 NumberOfOverflowDescriptors를 설정해야한다. 만약 총가능한 패킷디스크립터의 수(NumberOfDescriptors 더하기 NumberOfOverflowDescriptors)는 풀로부터 할당되었다면 NdisAllocatePacket의 호출은 NDIS_STATUS_RESOURCES를 리턴한다.

보내지고 인디케이트된 패킷이 할당한 드라이버로 리턴됐을때, 드라이버는 NdisReinitializePacket를 호출하고 버퍼디스크립터의 체인으로 다시 설정한후 각패킷디스크립터를 다시 사용할 수 있고 혹은 드라이버는 프리리스트에 그패킷을 리턴하는 NdisFreePacket를 호출할수 있다. 패킷풀로부터 할당된 다시초기화하고 다시사용하는 패킷들은 freeing하고 재할당하는것보다 훨씬 빠르다. 드라이버가 패킷디스크립터를 가지고 NdisReinitializePacket을 호출하기전에, 패킷디스크립로 체인된 버퍼디스크립터에 그 포인터를 저장해야만한다.

왜냐하면 NdisReinitializePacket은 버퍼체인의 헤드를 널로 설정하기때문에 드라이버가 더이상 패킷디스크립터를 요구하지않을때,드라이버는 NdisAllocatePacketPoolEx로 할당한 저장공간을 해제하기위해 NdisFreePacketPool을 호출한다.

NdisAllocatePacketPoolEx의 호출자들은 DISPATCH_LEVEL보다 작은 레벨에서 동작한다.