NdisDprFreePacketNonInterlocked

VOID NdisDprFreePacketNonInterlocked( IN PNDIS_PACKET Packet );

NdisDprFreePacketNonInterlocked함수는 드라이버 할당 패킷 디스크립터를 해제하고 호출자가 IRQL DISPATCH_LEVEL에서 동작될때 프리리스트로 그것을 리턴한다. 그리고 그 호출자는 패킷 POOL에 접근하는것에대해 내부적으로 동기화를 제공한다.

매개변수

Packet

NdisDprAllocatePacketNonInterlocked함수에의해 리턴된 패킷 디스크립터의 포인터.

주석

NdisDprFreePacketNonInterlocked함수를 호출하기전에, 드라이버는 패킷에 체인된 모든 버퍼 디스크립터들을 해제하기위해 필요한 만큼 NdisFreeBuffer함수를 호출해야만 한다. 혹은 버퍼 디스크립터들의 모든 포인터들을 저장하기위해 필요한 만큼 NdisUnchainBufferAtXxx함수를 호출해야만 한다. 그렇지 않으면, 체인내의 버퍼 디스크립터들과 관계된 메모리는 드라이버에의해 사용될수 없다.

NdisDprFreePacketNonInterlocked함수의 호출자와 상보적인 NdisDprAllocatePacketNonInterlocked함수는 드라이버가 NdisAllocatePacketPool함수로 할당한 패킷 POOL에 접근 하는 모든 동기화에대해 책임이 있다. 그렇지않으면, 드라이버는 NDIS가 NdisAllocate/FreePacket 혹은 NdisDprAllocate/FreePacket함수의 호출에의한 이익에 이 동기화를 다루도록 해야만한다.

일반적으로 그런 드라이버는 패킷 POOL을 드라이버 할당 스핀 락으로 보호한다. NdisDprFreePacketNonInterlocked함수의 호출전에, 드라이버는 NdisAcquireSpinLock함수를 호출한다. 이것은 IRQL 을 DISPATCH_LEVEL로 올린다. NdisDprFreePacketNonInterlocked함수가 컨추럴을 리턴할때, 그런 드라이버는 스핀락을 NdisReleaseSpinLock함수로 해제한다.

NdisDprFreePacketNonInterlocked함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작되어야만 한다.