ExAllocatePoolQuotaZero 関数 (wdm.h)

  • [アーティクル]

注意事項

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

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

ExAllocatePoolQuotaZero は、指定した型のプール メモリを割り当て、割り当てられたブロックへのポインターを返します。 これは ExAllocatePoolWithQuotaTag と 同じですが、割り当てられたメモリは 0 で初期化されます。 これが望ましくない場合は、代わりに ExAllocatePoolQuotaUninitialized を使用します。

構文

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

パラメーター

PoolType

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

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

NumberOfBytes

割り当てるバイト数。

Tag

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

戻り値

ExAllocatePoolQuotaZero は、割り当てられたプールへのポインターを返します。

要求を満たすことができない場合は、POOL_QUOTA_FAIL_INSTEAD_OF_RAISEが指定されていない限り、ExAllocatePoolQuotaZero によって例外が発生します。 パフォーマンス上の理由から、POOL_QUOTA_FAIL_INSTEAD_OF_RAISEを使用することをお勧めします。

注釈

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

このルーチンは、最初に I/O 要求を行ったプロセスのコンテキストで要求を満たすためにメモリを割り当てる最上位レベルのドライバーによって呼び出されます。 下位レベルのドライバーでは、代わりに ExAllocatePoolZero が呼び出されます。

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

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 2004 に WDK が必要です。 Windows 7 以降のバージョンの Windows オペレーティング システムを対象としています。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則 HwStorPortProhibitedDDIs、SpNoWait、StorPortStartIo

こちらもご覧ください

ExAllocatePoolQuotaUninitialized