NdisAllocateMemory
NDIS_STATUS
NdisAllocateMemory(
OUT PVOID *VirtualAddress,
IN UINT Length,
IN UINT MemoryFlags,
IN NDIS_PHYSICAL_ADDRESS HighestAcceptableAddress
);
|
NdisAllocateMemory함수는 존재하는(nonpaged) 시스템 공간 메모리를 할당한다. 지정된 주소 제한내에서, 물리적으로 연속적인 할당으로서, 그리고/혹은 비케쉬 할당으로서.
매개변수
- VirtualAddress
- 이 함수가 할당된 메모리의 기본적인 가상 주소를 리턴하는 것에대한 호출자제공 변수의 포인터,만약 지정된 타입의 메모리가 이용할수 없다면 NULL.
- Length
- 할당되어지는 바이트의 사이즈를 지정한다.
- MemoryFlags
- 제로 혹은 할당된 메모리 타입을 지정하는 비트마스크를 다음과 같이 지정한다.:
| 값 |
의미 |
| zero |
nonpaged시스템 공간 메모리를 할당한다. |
| NDIS_MEMORY_CONTIGUOUS |
물리적으로 연속적인 메모리를 할당한다. |
| NDIS_MEMORY_NONCACHED |
비 케쉬화된 메모리를 할당한다. |
단지 닉 드라이버들만이 드라이버 초기화시 연속적이거나 비 케쉬화된 메모리의 할당을 지정할수 있다. 이러한 두 플레그는 NdisAllocateMemory함수가 호출되기전에 MemoryFlags로 ORed되어질수 있다.
- HighestAcceptableAddress
- -1을 서술한다.
리턴값
NdisAllocateMemory함수는 다음중 하나를 리턴한다.
- NDIS_STATUS_SUCCESS
- 호출자는 VirtualAddress에 리턴된 값을 시작으로 할당된 메모리 범위를 사용할수있다.
- NDIS_STATUS_FAILURE
- 요청된 메모리를 할당하기위한 시도는 실패이다. 이 리턴은 다음에 이어지는 호출이 실패한다는 필수적인 의미가 아니다.
주석
NDIS드라이버는 NdisAllocateMemory함수를 MemoryFlags를 0으로 설정하여 호출할지 모른다. 예를들어, NDIS upper-edge함수들의 설정을 익스포트하는 NDIS드라이버들은 컨텍스트 영역을 드라이버가 닉당(혹은 가상 닉당)런타임 상태정보를 유지하고 VirtualAddress에 리턴된 포인터를 NdisMSetAttributes(Ex)로 넘기는것에있어 할당하기위해 NdisAllocateMemory함수를 호출할 수 있다. NDIS lower-edge(ProtocolXxx)함수의 설정을 익스포트하는 NDIS드라이버들 또한 그런 드라이버가 버퍼 공간을 할당할 필요가 있을때마다 NdisAllocateMemory를 호출할 수 있다.
NdisAllocateMemory 를 초기화시에 호출 하도록 했을때, 단지 NIC미니포트들만이 MemoryFlags를 NDIS_MEMORY_XXX를 둘다 혹은 하나를 설정할수있다. 초기화동안, 미니포트 드라이버들은 그들 닉과 공유되기위해 이런 타입의 메모리를 할당한다.
만약 그런 미니포트가 NdisAllocateMemory의 호출에서 물리적으로 연속적인 메모리를 지정한다면, 가상 메모리 할당은 하나의 물리적으로 연속적인 영역을 할당한다. 만약 미니포트가 비케쉬화되는 메모리를 지정한다면,할당된 가상 범위는 케쉬하되지않는다. 닉드라이버는 DMA연산동안 케쉬 버퍼를 플러쉬하는것없이 비케쉬화된 메모리를 접근할수있다.
입력 MemoryFlags의 값이 무엇이든, NdisAllocateMemory의 성공적인 호출자는 할당된 메모리에 접근하기위한 가상 주소들의 범위를 사용한다. 할당의 크기에 그리고 메모리 요청 타입에 의존하여, 하나 혹은 그이상의 물리 메모리범위(페이지)는 이 싱글 가상 범위를 back한다.
NDIS_MEMORY_XXX가 닉 드라이버에의해 연속적이고 비케쉬화되는 할당을 요청하기위해 MemoryFlags에 ORed될수 있는 반면에 두 연속적이고 비 케쉬화되는 메모리는 매우 제한된 시스템 메모리이다. 닉 드라이버는 필요이상으로 많은 연속적인 메모리 와/혹은 많은 비케쉬화되는 메모리를 요청해서는 안된다. 드라이버가 초기화 하는동안을 제외하고 이런 타입의 메모리중 하나를 할당하도록 하는 시도는 프로그래밍 에러이다. 그런 시도는 성공될것 같지가 않다. 왜냐하면 시스템 공간 메모리는 다른 커널모드 요소들에의한 할당으로 쪼개지고되므로, 다른 드라이버를 포함하여, 그리고 런타임 페이징 때문에.
만약 그런 초기화때의 호출이 실패하면, 닉드라이버는 하나 혹은 그이상의 작은 블럭의 연속적 이고/혹은 비케쉬화되는 메모리를 할당하려고 시도 할 수 있다. 만약 큰 블럭의 메모리를 할당할수없어서 초기화하는것을 실패하기보다는.
NdisAllocateMemory함수의 호출자는 비페이화되는 POOL로부터 메모리를 할당하기위해 IRQL<=DISPATCH_LEVEL에서 동작할수 있다. 연속적 이고/혹은 비케쉬화되는 메모리를 할당하는 닉드라이버는 초기화동안에 IRQL PASSIVE_LEVEL에서 동작되어야만 한다.
|