NdisAllocateFromNPagedLookasideList

PVOID NdisAllocateFromNPagedLookasideList( IN PNPAGED_LOOKASIDE_LIST Lookaside );

NdisAllocateFromNPagedLookasideList함수는 주어진 룩어사이드 리스트 헤드로부터 처음 엔트리를 제거한다. 만약 룩어 사이드 리스트가 현재 비어있다면, 엔트리는 nonpaged pool로부터 할당되어진다.

매개변수

Lookaside

엔트리가 할당되어진 것으로부터의 룩어사이드 리스트의 헤드의 포인터. 호출자는 이미 NdisInitializeNPagedLookasideList함수로 리스트 헤드를 초기화했다.

리턴값

NdisAllocateFromNPagedLookasideList함수는 만약 엔트리가 룩어사이드로부터 제거될수있거나 할당되어질수 있다면, 엔트리의 포인터를 리턴한다. 그렇지않으면 NULL을 리턴한다.

주석

만약 룩어사이드 리스트가 비어있다면, NdisAllocateFromNPagedLookasideList함수는 리스트로부터의 처음 엔트리를 제거하고 호출자의 주소를 리턴한다. 만약 룩어사이드 리스트가 비어있다면, NdisAllocateFromNPagedLookasideList함수는 호출자가 리스트의 초기화때 지정한 할당함수를 호출하거나 적어도 호출자의 편에서 엔트리를 할당한다. NdisAllocateFromNPagedLookasideList함수는 만약 호출자제공 할당 함수가 혹은 이 함ㅅ 자체가 nonpaged 엔트리를 할당할수 없다면, NULL을 리턴한다.

nonpaged 룩어사이드 리스트로 부터 할당된 모든 엔트리는 고정된 사이즈이고 드라이버가 NdisInitializedNPagedLookasideList함수를 처음에 호출할때 지정된다. 결과적으로 룩어사이드 리스트는 동적인 I/O요구에대한 응답의 상태를 유지하기위해 고정된 사이즈의 블럭들을 할당해야만 하는 드라이버에대하 특별하게 사용되어진다. 예를들어, 어떤 연결지향 NDIS드라이버는 (VC들이 만들어지는것과 각 VC가 해제되는 NdisFreeToNPagedLookasideList함수로 룩어사이드 리스트로 다시 각 엔트리를 해제되는 룩어사이드 리스트로부터 요구되어지는 VC컨텍스트 영역을 할당한다.

NdisAllocateFromNPagedLookasideList 호출자는 IRQL <= DISPATCH_LEVEL에서 동작어야만 한다.