NdisAllocatePacketPool

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

NdisAllocatePacketPool은 패킷 디스크립터들의 풀(pool)을 위한 저장 영역(block)를 할당하고 초기화한다.

매개변수

Status

이 함수가 패킷 풀(pool) 할당에 대한 상태를 리턴하는 호출자 제공 변수를 가리킨다. 다음과 같은 값들이 온다.

NDIS_STATUS_SUCCESS

드라이버는 NdisAllocatePacket호출을 상위 레벨 드라이버들로 인디케이션들을 올리기 위해 패킷 디스크립터들을 필요할 때 혹은 하위 레벨 드라이버들에게 패킷들을 아래로 보내기 위해 패킷 디스크립터들이 필요할 때 할 수 있다.

NDIS_STATUS_RESOURCES

패킷 풀(pool)을 할당하기 위한 시도가 메모리 부족에 때문에 실패한다. 이것은 반드시 연속적인 호출이 실패할 것이라는 것을 의미하지는 않는다. 그러나, 호출자는 NumberOfDescriptors를 줄이고 다시 즉시 호출해야 한다.

PoolHandle

이 함수는 패킷 풀(pool)에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다. 이 핸들은 드라이버가 계속해서 호출하는 Ndis...Packet 함수들에 대한 필요한 매개변수이다.

NumberOfDescriptors

풀(pool)이 포함하는 패킷 디스크립터 수를 지정한다.

ProtocolReservedLength

각 패킷 디스크립터의 ProtocolReserved를 위해 할당되어지는 바이트 수를 지정한다. 리시브 인디케이션에서 사용되어지는 패킷 디스크립터들을 위해, 이 매개변수는 적어도 16(바이트)가 될 것이다.

주석

NdisAllocatePacketPool에 대한 성공적인 호출은 패킷 풀(pool)에 대한 핸들을 리턴한다. 호출자는 이 값을 저장해야 한다. 항상, 드라이버는 다음에 패킷 디스크립터들을(a set of packt descriptors) 할당하기 위해 이 핸들을 가지고 한번이나 여러번 NdisAllocatePacket을 호출한다. NdisAllocatePacketPool에 대한 호출로 지정된 NumberOfDescriptors은 NdisFreePacket을 호출해서 패킷 풀(pool)를 위해 프리 리스트(free list)에 대한 패킷 디스크립터를 리턴하기 전에 드라이버는 NdisAllocatePacket를 호출할 수 있는 수에 대한 효율적인 제한이다.

보내고 혹은 인디케이트되는 패킷들이 할당한 드라이버에 리턴되어지면은 각 패킷 디스크립터는 NdisReinitializePacket 을 호출하고 다시 버퍼 디스크립터들 체인에 설정한 후 재 사용할 수 있고 혹은 NdisFreePacket을 호출하여 프리 리스트(free list)에 대한 그러한 패킷을 리턴할 수 있다. 패킷 풀(pool)로부터 할당된 패킷들을 재초기화하고 재사용하는 것은 해제해서 다시 재할당 하는 것보다 훨씬 빠르다. 드라이버가 패킷 디스크립터로 NdisReinitializePacket을 호출하기 전에 NdisReinitializePacket이 버퍼 체인의 헤드를 NULL로 설정한 후 패킷 디스크립터에 연결된(chained) 버퍼 디스크립터들에 대한 포인터들을 연결해야 한다.

드라이버가 더 이상 패킷 풀(pool)을 필요하지 않는다면은, NdisFreePacketPool을 호출해서 패킷 풀(pool)저장공간을 해제해야 한다.

NdisAllocatePacketPool에 대한 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.