NDIS_PAGABLE_FUNCTION
NDIS_PAGABLE_FUNCTION(FunctionName)
|
NDIS_PAGABLE_FUNCTION 함수는 페이저블 코드로써 드라이버 함수를 특징짓기 위해서 사용된 매크로이다.
매개변수
- FunctionName
- 페이저블되는 드라이버 함수의 이름을 서술한다.
주석
NDIS_PAGABLE_FUNCTION을 가지고 특징지어진 어떤 드라이버 함수는 통제를 리턴할 때 메모리 밖으로 페이지될 수 있다. 그리고 순차적으로 호출된다면 메모리 안으로 페이지된다.
예를들어 그러한 함수는 다음과 같이 드라이버 소스에서 선언된다:
VOID miniportXxx(...);
#pragma NDIS_PAGABLE_FUNCTION(miniportXxx)
... // 다른 함수 선언
VOID
miniportXxx(...)
{
...
}
...
윈도우즈 2000에서 페이지 연산이 IRQL < DISPATCH_LEVEL에서 실행되기 때문에 IRQL >= DISPATCH_LEVEL에서 실행할 수 있는 어떤 드라이버 함수는 페이저블될 수 없다. IRQL >= DISPATCH_LEVEL에서의 실행될 때 드라이버 함수를 페이저블하는 것은 그 드라이버에서 치명적인 페이지폴트를 야기할 수 있다.
보통 NIC 드라이버는 그들의 MiniportInitialize나 MiniportHalt 함수에서 이 매크로를 사용할 수 있다. 또한 미니포트는 페이저블로 특징지어진 함수가 NdisAcquireSpinLock 함수처럼 IRQL을 상승시키는 어떤 NdisXxx 함수를 호출하지 않는 한MiniportInitialize나 MiniportHalt 함수에서만 호출되는 내부의 드라이버 함수에서 이 매크로를 사용할 수 있다.
NDIS 프로토콜 드라이버는 IRQL < DISPATCH_LEVEL에서 항상 실행하는 어떤 드라이버 함수에서 이 매크로를 사용할 수 있다. 그러한 함수는 상승된 IRQL에서 절대 호출되지 않는다. 그러한 함수는 IRQL >= DISPATCH_LEVEL에서 실행하는 시스템 제공 함수 혹은 드라이버를 호출할 수 없다.
|