NdisBufferVirtualAddressSafe
PVOID
NdisBufferVirtualAddressSafe(
IN PNDIS_BUFFER Buffer
IN UINT Priority
);
|
NdisBufferVirtualAddressSafe함수는 NdisBufferVirtualAddress의 안전 버전이다. NdisBufferVirtualAddress함수와 다르게, NdisBufferVirtualAddressSafe 함수는 만약 시스템 리소스들이 낮거나 다써버렷다면, 버그체크를 하지 않을것이다(애매). 드라이버들은 NdisBufferVirtualAddress대신에 NdisBufferVirtualAddressSafe함수를 호출해야 한다.
매개변수
- Buffer
- 기본 가상 주소가 리턴되는것으로부터의 버퍼 디스크립터에대한 포인터
- Priority
- 다음중 하나로써 요청의 우선순위를 가리킨다.:
- LowPagePriority
- 낮은 우선순위를 나타낸다. 만약 시스템 리소스가 낮다면 NdisBufferVirtualAddressSafe는 실패이다.
- NormalPagePriority
- 보통의 우선순위를 나타낸다. 만약 시스템 리소스가 낮다면 NdisBufferVirtualAddressSafe함수는 실패이다.
- HighPagePriority
- 높은 우선순위를 나타내다. 만약 시스템 리소스가 다써버리지 않았다면 NdisBufferVirtualAddressSafe함수는 실패가 아니다.
리턴값
NdisBufferVirtualAddressSafe함수는 다음중 하나를 리턴한다.:
- 주어진 버퍼 디스크립터에의해 설명된 물리 페이지를 멥하는 기본 시스템 공간 가상 주소.
- 만약 시스템 리소스가 낮거나 (만약 우선순위가 LowPagePriority 혹은 NormalPagePriority로 설정되었다면) 혹은 다 써버렸다면(만약 우선순위가 HighPagePriority로 설정되었다면) NULL.
주석
NdisBufferVirtualAddressSafe함수는 주어진 버퍼 디스크립터에의해 맵된 버퍼에대해 기본 가상 주소를 리턴한다. 만약 이러한 페이지가 아직 시스템 공간에 맵되지 않았다면 시스템 공간에 주어진 버퍼 디스크립터에의해 설명된 물리 페이지를 맵한다.
PIO장치들에대한 드라이버들은 시스템 공간 주소 범위에서의 사용장 버퍼에대해 버퍼에 의해 지정된 가상 주소 범위로 전환하기위해 이루틴을 사용한다.
리턴된 기본 주소는 버퍼내의 가상주소로써 같은 옵셋을 가지고 있다.
만약 우선순위가 LowPagePriority 혹은 NormalPagePriority로 설정되어있다면, NdisBufferVirtualAddressSafe함수는 만약 리소스가 낮거나 다 없어졌다면, NULL을 리턴한다. 만약 우선 순위가 HighPagePriority로 설정되었다면, NdisBufferVirtualAddressSafe함수는 만약 시스템 리소스가 다 없어졌다면 NULL을 리턴한다.
드라이버는 NdisBufferVirtualAddress대신에 NdisBufferVirtualAddressSafe함수를 호출해야한다. 만약 시스템 리소스가 낮거나 다없어졌다면, NdisBufferVirtualAddress함수를 호출하는것은 버그 체크를 야기한다.
NdisBufferVirtualAddressSafe의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작되어질수 있다. 그러나 IRQL <= DISPATCH_LEVEL에서 동작하는 호출자는 nonpaged시스템 공간 주소를 멥하는 버퍼 디스크립터를 제공해야만한다. 버퍼 그자체는 nonpaged pool, 연속적인 메모리, or 비케쉬화된 메모리로부터 할당되어져야만 한다.
|