NdisInitializeNPagedLookasideList
VOID
NdisInitializeNPagedLookasideList(
IN PNPAGED_LOOKASIDE_LIST Lookaside,
IN PALLOCATE_FUNCTION Allocate OPTIONAL,
IN PFREE_FUNCTION Free OPTIONAL,
IN ULONG Flags,
IN ULONG Size,
IN ULONG Tag,
IN USHORT Depth
);
|
NdisInitializeNPagedLookasideList함수는 룩어사이드 리스트를 초기화 한다. 성공적인 초기화후, 비페이지화되는 고정된 사이즈 블럭은 룩어사이드 리스트로부터 할당되고 룩어사이드로 해제된다.
매개변수
- Lookaside
- 초기화되는 호출자 할당 룩어사이드 리스트헤드의 포인터. 드라이버는 상주하는 즉 비페이지화되는 시스템 공간인 리스트 헤드를 제공해야만 한다.
- Allocate
- NULL이거나 호출될때마다 지정된 사이즈의 엔트리를 할당할 호출자 제공 함수의 엔트리 포인트를 지정한다. 만약 Allocate가 NULL이면, NdisAllocateFromNPagedLookasideList함수는 순차적으로 호출자를 대신하여 엔트리들을 할당한다. 만약 호출자가 Allocate함수를 제공한다면, Free함수도 제공해야만한다.
- Free
- NULL이거나 호출될때마다 지정된 사이즈의 엔트리를 해제할 호출자 제공 함수의 엔트리 포인트를 지정한다. 만약 Free가 NULL이면, NdisFreeToNPagedLookasideList함수는 호출자를 대신하여 엔트리들을 해제한다.
- Flags
- 0이어야만 한다. 이 파라미터는 시스템사용으로 예약되었다.
- Size
- 룩어사이드 리스트로부터 순차적으로 할당되어지는 각 엔트리의 바이트 사이즈를 지정한다.
- Tag
- 룩어사이드 리스트 엔트리들에대한 호출자 제공 POOL 태그를 지정한다. 그 태그는 하나의 인용 부호들(예를들어 'derF')에의해 구분되어지는 4문자들의 스트링이다. 그 캐릭터들은 일반적으로 역순으로 지정된다. 그래서 디버거에서 덤핑 POOL혹은 트랙킹 POOL의 사용시 더욱 쉽게 읽을수 있다.
- Depth
- 0이어야만 한다. 이 파라미터는 또한 시스템 사용에의해 예약됐다.
주석
NdisInitializeNPagedLookasideList함수는 호출자 제공 리스트 헤드를 초기화 하지만 리스트 엔트리에대한 메모리는 할당하지 않는다. 처음의 엔트리들은 NdisAllocateFromNPagedLookasideList함수의 호출이나 드라이버제공 할당 콜벡으로 필요한만큼을 토대로 할당되어진다. 리스트는 드라이버가 엔트리들을 다시 NdisFreeToNPagedLookasideList함수로 리스트로 해제할때 놓여질 것이다(애매). 엔트리들은 시스템의존이지만 동적인 사이즈 제한이 다다를때까지 리스트를 수집한다. 그리고나서, 룩어사이드 리스트내의 어떤 잉여 엔트리들은 NdisFreeToNPagedLookasideList함수혹은 드라이버 제공 Free콜벡의 호출로 비페이지화된 pool로 리턴된다.
룩어사이드 리스트내의 모든 엔트리들은 같은 사이즈이다. 이것은 드라이버가 NdisInitializeNPagedLookasideList함수를 호출할때 지정된 사이즈이다. 룩어사이드 리스트는 빈번한 I/O연산들에대한 런타임 상태를 유지하기위한 고정된 컨텍스트 영역들을 동적으로 할당하고 해제해야만 하는 드라이버들에게 특히 유용하게 사용된다. 예를들어, 연결지향 NDIS드라이버들은 룩어사이드 리스트들을 특히 찾을지 모른다. 왜냐하면 그런 드라이버들은 일반적으로 나가거나 들어오는 호출들에대한 동적 컨텍스트 영역의 설정을 유지하기때문이다.
NdisAllocate/Free..LookasideList함수가 엔트리들의 할당과 할당해제를 다루도록 하는것이 더욱 효과적이다. 그러나, 메모리 사용에대해 내부적으로 상태를 추적하는 드라이버는 Allocate과 Free함수를 NdisInitializeNPagedLookasideList에게 제공할지 모른다.
NdisInitializeNPagedLookasideList함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작해야만하지만, PASSIVE_LEVEL에서 동작해야만 한다.
|