MmMapMdl 関数 (wdm.h)

この関数は、メモリ記述子リスト (MDL) によって記述された物理ページをシステム仮想アドレス空間にマップします。

構文

NTSTATUS MmMapMdl(
  [in] PMDL            MemoryDescriptorList,
  [in] ULONG           Protection,
  [in] PMM_MDL_ROUTINE DriverRoutine,
  [in] PVOID           DriverContext
);

パラメーター

[in] MemoryDescriptorList

有効な MDL へのポインター。

[in] Protection

ページに対して設定する保護を示すフラグのビットごとの 。 使用できる値は、Wdm.h で定義PAGE_Xxx定数です。

[in] DriverRoutine

MDL のマップ後に呼び出されるドライバー指定のコールバック ルーチン (MM_MDL_ROUTINE) へのポインター。

[in] DriverContext

ドライバー定義コンテキストへのポインター。 ドライバーのコールバック関数は、ドライバー コンテキストに状態情報を格納し、コールバックが呼び出されたときに値を調べることができます。

戻り値

DriverRoutine が指すコールバック関数が呼び出された場合、この関数はSTATUS_SUCCESSを返します。 MDL をマップできなかったか、コールバック関数を呼び出せなかった場合、関数は適切な NTSTATUS 値を返します。

注釈

MmMapMdl は MDL をマップし (まだマップされていない場合)、コールバックを呼び出し、マッピングを解放します (作成されている場合)。 呼び出し元はクリーンアップを実行する必要はありません。

要件

こちらもご覧ください

MM_MDL_ROUTINE