NdisDprAllocatePacket

VOID NdisDprAllocatePacket( OUT PNDIS_STATUS Status, OUT PNDIS_PACKET *Packet, IN NDIS_HANDLE PoolHandle );

호출자가 IRQL DISPATCH_LEVEL에서 동작되고 있을때, NdisDprAllocatePacket함수는 패킷 디스크립터를 할당하고 초기화한다.

매개변수

Status

이 함수가 요청에 대한 마지막 상태를 리턴하는것에 대한 호출자 할당 변수의 포인터, 이것은 다음중 하나일 수 있다. :

NDIS_STATUS_SUCCESS

호출자는 Packet에 리턴된 패킷 디스크립터를 사용할수 있다.

NDIS_STATUS_RESOURCES

현재 패킷 풀(POOL)에대한 프리 리스트는 더 이상 이용할수 없는 엔트리이다. NdisDprFreePacket 혹은 NdisFreePacket함수에대한 순차적인 호출은 프리 리스트에대한 주어진 엔트리를 리턴한다. Packet변수는 NULL로 설정된다.

Packet

이 함수는 할당된 패킷 디스크립터에대한 포인터를 리턴하는 호출자 할당 변수의포인터.

PoolHandle

이전의 NdisAllocatePacketPool함수의 호출에의해 리턴된 핸들을 지정한다.

주석

NdisDprAllocatePacket함수는 NdisAllocatePacket함수보다 아주 조금 빠르게 동작한다. 왜냐하면 NDIS는 상승된 IRQL없이 패킷 POOL에 동기적으로 접근하기위해 사용하는 스핀 락을 허용할수 있기 때문에.

NdisDprAllocatePacket함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작되어야만 한다. 그렇지 않으면, 드라이버는 NdisAllocatePacket함수를 호출해야만 한다.