mmLockPagableDataSection 函数 (wdm.h)

项目
02/27/2024

MmLockPagableDataSection 例程将驱动程序数据的整个部分锁定到系统空间中。

语法

PVOID MmLockPagableDataSection(
  [in] PVOID AddressWithinSection
);

参数

[in] AddressWithinSection

指定可分页节中一项数据的符号地址。

返回值

MmLockPagableDataSection 返回标识节的不透明值。此值必须随后传递给 MmLockPagableSectionByHandle 或 MmUnlockPagableImageSection。

注解

驱动程序可以使用此例程 MmLockPagableSectionByHandle 和 MmUnlockPagableImageSection 将其通常可分页的专用数据锁定到内存中。

在以下的情况下，可以锁定数据：

通常以 = APC_LEVEL 访问 <数据，但可能需要在短时间内以较高的 IRQL 级别访问这些数据。
驱动程序不经常和可预测的使用数据。

例如，mixer 设备的驱动程序使用可分页数据部分。由于驱动程序使用足够的数据来创建可分页数据节，并且驱动程序知道何时需要数据，因此，此类驱动程序使用 MmLockPagableDataSection、 MmLockPagableSectionByHandle 和 MmUnlockPagableImageSection 将数据部分引入系统空间，并在不需要时将其分页。

对 MmLockPagableDataSection 的 一次调用会导致包含引用数据的整个部分被锁定到系统空间中。

锁定分区是一项代价高昂的操作。如果驱动程序在多个位置锁定了可分页数据部分，请对第一个请求使用 MmLockPagableDataSection 。通过调用 MmLockPagableSectionByHandle，传递 MmLockPagableDataSection 返回的句柄，发出后续锁定请求。句柄锁定可显著提高驱动程序性能。通过调用 MmUnlockPagableImageSection 解锁锁定的分区。

内存管理器维护节上的引用计数。仅当引用计数为零时，可分页数据节才可用于分页。每个锁请求都会递增计数;每个解锁请求都会减少计数。驱动程序必须像锁定分区一样多次解锁分区，以确保在不需要分区时，此类分区可供分页。无论计数如何，句柄始终有效。如果句柄上的计数为零，并且调用 了 MmLockPagableSectionByHandle，则计数设置为 1，如果分区已分页，则将分页。

可分页数据节中的数据由编译器指令标记。若要创建可分页的数据部分，请在数据模块的开头使用 #pragma data_seg (“PAGE”) ，并在模块末尾 使用 #pragma data_seg () 。关键字 (keyword) PAGE 区分大小写，即 PAGE 必须大写。

请注意，还有一个 #pragma data_seg (“INIT”) ，用于在系统初始化后使数据可丢弃。除了使用 INIT 而不是 PAGE 外，语法是相同的。但结果不是：使用 PAGE 指令使数据节可分页。使用 INIT 指令时，一旦驱动程序从其驱动程序入口例程或其重新初始化例程返回（如果驱动程序有该例程），就会丢弃节中的数据。

有关分页数据的详细信息，请参阅使驱动程序可分页。

要求

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI (storport) ， IrqlMmApcLte (wdm)