次の方法で共有


ExAllocatePoolZero 関数 (wdm.h)

注意

Microsoft は、Windows 10 バージョン 1909 で割り当てがゼロにならない可能性がある ExAllocatePoolZero の問題を認識しています。 この問題は、2020 年 12 月 16 日に、Windows 10 バージョン 2004 用 WDK と Windows 10 バージョン 2004 用 Enterprise WDK (EWDK) のセキュリティ更新で修正されました。 最新の WDK のダウンロードについては、「Windows Driver Kit (WDK)をダウンロードする」を参照してください。

このルーチンは、ExAllocatePoolWithTag のラッパーであり、推奨される置換オプションです。

ExAllocatePoolZero は、指定された型のプール メモリを割り当て、割り当てられたブロックへのポインターを返します。 ExAllocatePoolWithTag と同じですが、割り当てられたメモリが 0 で初期化される点が異なります。

構文

PVOID ExAllocatePoolZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag
);

パラメーター

PoolType

割り当てるプール メモリの種類。 使用可能なプール メモリの種類の詳細については、POOL_TYPEを参照してください。

列挙値を変更するには、wdm.hで定義されたPOOL_RAISE_IF_ALLOCATION_FAILURE フラグを使用してビットごとの OR を実行します。 このフラグを指定すると、要求を満たすことができない場合に例外が発生します。 このフラグはコストがかかるため、使用しないことをお勧めします。

同様に、PoolType 値を変更するには、この値をPOOL_COLD_ALLOCATION フラグ (wdm.hでも定義) を使用してビットごとの ORing をカーネルにヒントとして付けて、ページアウトされる可能性が高いページからメモリを割り当てることができます。 常駐プール メモリの量をできるだけ減らすには、これらの割り当てを頻繁に参照しないでください。 POOL_COLD_ALLOCATION フラグは、唯一のアドバイザリです。

NumberOfBytes

割り当てるバイト数。

Tag

割り当てられたメモリに使用するプール タグ。 単一引用符で区切られた 1 ~ 4 文字の 0 以外の文字リテラルとしてプール タグを指定します (例: Tag1)。 通常、文字列は逆の順序で指定されます (たとえば、1gaT)。 タグ内の各 ASCII 文字は、0x7E (チルダ) 0x20 (スペース) の範囲内の値である必要があります。 各割り当てコード パスでは、デバッガーと検証ツールがコード パスを識別するのに役立つ一意のプール タグを使用する必要があります。

戻り値

要求を満たすために空きプールにメモリが不足している場合、ExAllocatePoolZero は NULL を返します。 それ以外の場合、ルーチンは割り当てられたメモリへのポインターを返します。

備考

このルーチンは、メモリの一般的なプール割り当てに使用されます。

Windows 10 バージョン 2004 より前のバージョンの Windows で実行するには、ドライバーでPOOL_ZERO_DOWN_LEVEL_SUPPORTを定義し、この関数を呼び出す前 ExInitializeDriverRuntime を呼び出す必要があります。

この関数と ExAllocatePoolWithTag の唯一の違いは、メモリがゼロ初期化されていることです。 これが望ましくない場合は、ExAllocatePoolWithTag のラッパー ExAllocatePoolUninitialized を代わりに使用します。

ドライバーは、割り当てるバイト範囲内のメモリにのみアクセスする必要があります。 この範囲外のメモリにアクセスすると、プールが破損し、システムがクラッシュする可能性があります。

追加のガイダンスについては、exAllocatePoolWithTag の「解説」セクション 参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 2004 用 WDK が必要です。 Windows 7 以降のバージョンの Windows オペレーティング システムを対象としています。
ターゲット プラットフォーム 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
IRQL IRQL <= DISPATCH_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則 する CheckDeviceObjectFlags、HwStorPortProhibitedDDIs、IrqlExAllocatePool、IrqlExFree1、PowerDownAllocate、PowerUpFail、SpNoWait、StorPortStartIo

関連項目

ExAllocatePoolUninitialized