MmAllocateNonCachedMemory 関数 (ntddk.h)

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

MmAllocateNonCachedMemory ルーチンは、キャッシュされていないメモリとキャッシュアラインメモリの仮想アドレス範囲を割り当てます。

構文

PVOID MmAllocateNonCachedMemory(
  [in] SIZE_T NumberOfBytes
);

パラメーター

[in] NumberOfBytes

割り当てる範囲のサイズをバイト単位で指定します。

戻り値

要求されたメモリを割り当てることができない場合、戻り値は NULL です。それ以外の場合は、割り当てられた範囲のベース仮想アドレスです。

注釈

MmAllocateNonCachedMemory を DriverEntry ルーチンから呼び出して、さまざまなデバイス固有のバッファーに対してキャッシュされていない仮想メモリブロックを割り当てることができます。関数は、要求された割り当てサイズに関係なく、非ページシステムアドレス空間メモリの仮想メモリページサイズの完全な倍数を常に返します。

キャッシュされていない割り当ては、キャッシュと一貫性の問題を防ぐために、プロセッサのデータキャッシュ行サイズの整数倍数に配置されます。

MmAllocateNonCachedMemory から返される物理メモリページは、通常、連続したページではありません。

MmAllocateNonCachedMemory によって割り当てられるメモリが初期化されていません。カーネルモードドライバーは、このメモリをユーザーモードソフトウェアに表示する場合は、まずこのメモリをゼロにする必要があります (特権のある可能性のあるコンテンツがリークされないようにするため)。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntddk.h (Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<=APC_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm), SpNoWait(storport), StorPortStartIo(storport)