#pragma alloc_text

编译时控制分页能力

   有时，驱动程序的某些部分必须驻留内存而另一些可以被分页，这就需要一种能控制代码和数据是否分页的方法。通过指导编译器的段分配可以实现这个目的。在运行时，装入器通过检查驱动程序中的段名, 把段放到你指定的内存池中。此外在运行时调用内存管理器的例程也能实现这个目的。

需要注意的是：
-------------------------------------------------------------------------------- 
（1） Win32 执行文件，包括内核模式驱动程序，在内部都是由一个或多个段组合而成。段可以包含代码或数据，通常还会有诸如可读性、可写性、共享性、执行性，等等附加属性。段是指定分页能力的最小单元。当装载一个驱动程序映像时，操作系统把以“page”或“.eda(.edata)”为段名开头的段放到分页池中，除非 HKLM/System/CurrentControlSet/Control/Session Manager/Memory Management中的DisablePagingExecutive值被设置(在这种情况下，驱动程序占用的内存不被分页)。

（2） 在Windows 2000中运行Soft-ICE需要用这种方式禁止内核分页。但这使得把驱动程序代码或数据误放到分页池中所造成的错误特别难以查找。如果你使用这种调试器，我推荐你最好使用PAGED_CODE宏和驱动程序检查器。

（3） 使编译器把代码放到特定段的传统方法是使用alloc_text编译指示。但不是每种编译器都支持这个编译指示，判断DDK中是否定义了ALLOC_PRAGMA可以帮助决定能否使用alloc_text编译指示。这个编译指示可以把驱动程序的单独例程放到特定段中： 

#ifdef ALLOC_PRAGMA 
#pragma alloc_text(PAGE, AddDevice) 
#pragma alloc_text(PAGE, DispatchPnp) 
... 
#endif 

上面语句把AddDevice和DispatchPnp函数的代码放到分页池中。 

（4） 如果某些代码在驱动程序完成初始化后不再需要，可以直接把它插入到INIT段。例如： 

#pragma alloc_text(INIT, DriverEntry)

加个头无非就是说明该函数是分在 分页内存 非分页内存，初始内存等等...

例如：

 #pragma alloc_text(PAGE, a) 
 #pragma alloc_text(PAGE, b) 

   表示函数a和b都运行在分页内存中，就是有可能被交换到分页池中，程序中一些高等级，例如dispatch 级别的代码当然不能运行在分页内存，这样往往出现BSOD

另外#pragma alloc_text(INIT, DriverEntry) 
像入口函数代码在驱动程序完成初始化后往往不再需要，可以直接把它插入到INIT段。

ps.Microsoft的C/C++编译器在alloc_text的使用上加了两个限制：

1、该编译指示必须跟在函数声明后面而不能在前面。你可以把驱动程序中的所有函数集中到一个头文件中，并在包含该头文件的源文件中，在#include语句的后面使用alloc_text。 
2、该编译指示仅能用于有C连接形式的函数。即，它不能用于类成员函数或 C++源文件中未用extern "C"声明的函数

#pragma alloc_text