NdisDprAllocatePacketNonInterlocked
VOID
NdisDprAllocatePacketNonInterlocked(
OUT PNDIS_STATUS Status,
OUT PNDIS_PACKET *Packet,
IN NDIS_HANDLE PoolHandle
);
|
호출자가 IRQL DISPATCH_LEVEL에서 동작되고 그 호출자가 패킷 POOL에 내부적인 동기접근을 제공때, NdisDprAllocatePacketNonInterlocked함수는 패킷 디스크립터를 할당하고 초기화 한다.
매개변수
- Status
- 이 함수가 요청에 대한 마지막 상태를 리턴하는 호출자 변수의 포인터, 이것은 다음중 하나일수 있다.:
- NDIS_STATUS_SUCCESS
- 호출자는 Packet에 리턴된 패킷 디스크립터를 사용할수 있다.
- NDIS_STATUS_RESOURCES
- 현재 패킷 POOL에대한 프리 리스트는 더이상 이용할수 없다. NdisDprFreePacketNonInterlocked함수에대한 순차적인 호출은 프리 리스트로 주어진 엔트리를 리턴할것이다. Packet변수는 NULL로 설정 될 것이다.
- Packet
- 이 함수가 할당된 패킷 디스크립터에대한 포인터를 리턴하는 것에대한 호출 할당 변수의 포인터.
- PoolHandle
- 이전의 NdisAllocatePacketPool함수의 호출에의해 리턴된 핸들을 지정한다.
주석
NdisDprAllocatePacketNonInterlocked함수의 호출자와 상보하는 NdisDprFreePacketNonInterlocked함수는 드라이버가 NdisAllocatePacketPool함수로 할당한 패킷 POOL에대한 동기적인 모든 접근에대해 책임이 있다. 그렇지 않으면, 드라이버는 NDIS가 NdisAllocatePacket 혹은 NdisDprAllocatePacket함수의 호출에의한 이익에 이 동기화를 다루도록 허용해야만한다.
NdisDprAllocatePacketNonInterlocked함수는 NdisAllocatePacket함수보다 조금 빠르다. 왜냐하면 NDIS는 전형적으로 드라이버가 할당한 패킷POOL에 동기적인 접근을 사용하는 것에대해 NDIS는 스핀 락을 허용할 필요가 없다.
대신, NdisDprAllocatePacketNonInterlocked와 NdisDprFreePacketNonInterlocked 함수의 호출자는 내부적으로 패킷 POOL에 접근하는것을 동기적으로 다루어야만 한다.
일반적으로, 그런 드라이버는 드라이버 할당 스핀 락으로 패킷 POOL을 보호한다. NdisDprAllocatePacketNonInterlocked함수의 호출전에 드라이버는 상승된 IRQL DISPATCH_LEVEL인 NdisAcquireSpinLock함수를 호출한다. 단지 드라이버가 스핀 락을 잡고 있는 동작을 다시 시작할때 NdisDprAllocatePacketNonInterlocked함수를 호출한다. NdisDprAllocatePacketNonInterlocked 함수가 컨추럴을 리턴할때, 그런 드라이버는 그런 스핀락을 NdisReleaseSpinLock함수로 해제한다.
NdisDprFreePacketNonInterlocked함수로 POOL로 다시 패킷 디스크립터를 해제하고 NdisReleaseSpinLock함수를 호출하기전에 비슷한 방법으로 그런 드라이버는 NdisAcquireSpinLock함수를 호출한다.
드라이버가 언로드하기전에 할당한 리소스들을 해제 할때를 제외하고 NdisDprAllocatePacketNonInterlocked함수로 할당된 어떤 패킷 디스크립터는 NdisDprFreePacketNonInterlocked함수로 해제해야만한다. 그렇지 않으면, 그것은 만약 패킷 디스크립터가 NdisDprAllocatePacketNonInterlocked함수로 할당됐다면 NdisDprFreePacket 혹은 NdisFreePacket함수로 어떤 패킷 디스크립터를 해제하기위해 레이스 상태를 야기 할수 있는 런타입 동기화 에러이다.
NdisDprAllocatePacketNonInterlocked함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작되어야만한다.
|