MmLockPagableSectionByHandle 函式 (ntddk.h)

發行項
02/29/2024

MmLockPagableSectionByHandle 例程會將可分頁程式代碼或數據區段鎖定為系統記憶體，方法是遞增區段句柄上的參考計數。

語法

void MmLockPagableSectionByHandle(
  [in] PVOID ImageSectionHandle
);

參數

[in] ImageSectionHandle

可分頁程式代碼或數據區段的句柄。呼叫端從先前呼叫 MmLockPagableCodeSection 或 MmLockPagableDataSection 例程取得此句柄。

傳回值

無

備註

驅動程式一開始會呼叫 mmLockPagableCodeSection 或 MmLockPagableDataSection ，以取得可分頁程式代碼或數據區段的句柄。之後，驅動程式可以呼叫 MmLockPagableSectionByHandle 和 MmUnlockPagableImageSection 來遞增和遞減句柄上的參考計數。

MmLockPagableCodeSection 或 MmLockPagableDataSection 呼叫會將可分頁的區段鎖定到系統記憶體中、將區段的句柄傳回，並將句柄上的參考計數初始化為一。 MmLockPagableSectionByHandle 會將參考計數遞增一， 而 MmUnlockPagableImageSection 會將參考計數遞減一。

如果句柄上的參考計數為非零，則會鎖定可分頁的區段。如果參考計數為零，則會解除鎖定區段。

只要驅動程式保留在記憶體中載入，可分頁區段的句柄就會保持有效。驅動程式可以使用相同的句柄來重複鎖定和解除鎖定區段。也就是說，驅動程式可以重複使用其參考計數為零的句柄。 MmLockPagableSectionByHandle 會檢查參考的區段是否位於呼叫端的位址空間中，如果是的話，只要遞增區段上的參考計數即可。如果區段不是常駐的， 則區段中的 MmLockPagableSectionByHandle 頁面會將其鎖定在系統空間中，並將參考計數設定為一。

為了避免系統記憶體流失，從記憶體卸除驅動程式時，句柄上的參考計數必須為零。否則，在驅動程式卸除之後，可分頁區段會持續鎖定到系統記憶體中。

如果驅動程式正在準備卸除，而且句柄上的參考計數為非零，驅動程式應該呼叫 MmUnlockPagableImageSection ，在卸載發生之前將計數遞減為零。

驅動程式無法呼叫 MmLockPagableSectionByHandle 來鎖定傳入 IRP 的用戶緩衝區。請改用 MmProbeAndLockPages 。

如需分頁程式代碼和數據的詳細資訊，請參閱讓驅動程式可分頁。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	ntddk.h (包含 Ntddk.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 IrqlMmApcLte (wdm)