MmBuildMdlForNonPagedPool 関数 (wdm.h)

[アーティクル]
08/08/2023

MmBuildMdlForNonPagedPool ルーチンは、非ページ仮想メモリバッファーを指定する MDL を受け取り、基になる物理ページを記述するように更新します。

構文

void MmBuildMdlForNonPagedPool(
  [in, out] PMDL MemoryDescriptorList
);

パラメーター

[in, out] MemoryDescriptorList

非ページメモリ内の仮想メモリバッファーを指定する MDL へのポインター。呼び出し元は IoAllocateMdl ルーチンを使用して、このバッファーの MDL を作成しました。

戻り値

なし

解説

入力時に、指定された MDL は、PoolType = NonPagedPool を使用する ExAllocatePoolWithTag ルーチンまたは MmAllocateContiguousMemorySpecifyCache ルーチンによって割り当てられるメモリなど、非ページシステムメモリまたはロックダウンされたメモリ内のバッファーを記述する必要があります (物理ページを交換できません)。 MmBuildMdlForNonPagedPool は、基になる物理ページを記述するように MDL を更新します。

MmBuildMdlForNonPagedPool は、カーネルスタックに割り当てられたバッファーを記述する MDL では使用できません。カーネルスタックバッファーを記述する MDL をビルドするには、ドライバーは MmProbeAndLockPages を呼び出す必要があります。これは、カーネルスタックページがプローブとロックされていない限り、交換できるためです。この規則は、ドライバーがカーネルスタックをページングできないことを保証する場合でも適用されます。

MDL によって記述されるページは既にページが使用できず、既にシステムアドレス空間にマップされているため、ドライバーは MmProbeAndLockPages ルーチンを使用してロックしたり、 MmMapLockedPagesSpecifyCache ルーチンを使用して追加のシステムアドレス空間マッピングを作成したりしないでください。同様に、ドライバーは MmUnlockPages ルーチンを使用してページのロックを解除したり、 MmUnmapLockedPages ルーチンを使用して既存のシステムアドレス空間マッピングを解放したりしないでください。 MmBuildMdlForNonPagedPool によってビルドされた MDL に対してドライバーがこれらの無効な操作のいずれかを実行した場合、結果の動作は未定義になります。

MmBuildMdlForNonPagedPool によって構築された MDL を MmGetSystemAddressForMdlSafe ルーチンに渡すことが許可されます。 MmGetSystemAddressForMdlSafe 呼び出しでは、MDL で記述されているバッファーの開始仮想アドレスを返すだけです。

ドライバーは 、MmMapLockedPagesSpecifyCache ルーチンを使用して、 MmBuildMdlForNonPagedPool によって構築された MDL をユーザー仮想アドレス空間にマップできます。ただし、ドライバーは、特定のセキュリティの問題を回避する方法でこの操作を実行する必要があります。詳細については、「 MmMapLockedPagesSpecifyCache」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<=DISPATCH_LEVEL