FsRtlAllocateAePushLock 関数 (ntifs.h)

fsRtlAllocateAePushLock 、自動展開プッシュ ロックを割り当てて初期化します。

構文

PVOID FsRtlAllocateAePushLock(
  [in] POOL_TYPE PoolType,
  [in] ULONG     Tag
);

パラメーター

[in] PoolType

自動拡張プッシュ ロックに割り当てるプール メモリの種類。 使用可能なプール メモリの種類の説明については、POOL_TYPE を参照してください。 PoolType 値は、POOL_RAISE_IF_ALLOCATION_FAILURE フラグを使用してビット単位で ORing することで変更できます。 割り当て要求が満たされない場合、このフラグによって例外が発生します。

[in] Tag

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

戻り値

FsRtlAllocateAePushLock は、空きプールに要求を満たすメモリが不足している場合に NULL を返します。 それ以外の場合、ルーチンは、割り当て済みの初期化された自動展開プッシュ ロックへのポインターを返します。

備考

FsRtlAllocateAePushLock は、自動展開プッシュ ロックのプール メモリを割り当てるために使用されます。 自動展開プッシュ ロックの詳細については、FSRTL_ADVANCED_FCB_HEADER を参照してください。

システムは、プール タグを割り当てられたメモリに関連付けます。 WinDbgなどのプログラミング ツールでは、割り当てられた各バッファーに関連付けられているプール タグを表示できます。 Gflags(Windowsのデバッグ ツール に含まれるツール) では、特定のプール タグに対する特別なプール 割り当てを要求するシステム機能が有効になります。 WDK に含まれる Poolmon、プール タグによってメモリを追跡します。

FsRtlAllocateAePushLock の呼び出し元は、割り当てられた自動展開プッシュ ロックを解放するために、その後 FsRtlFreeAePushLock 呼び出す必要があります。

プールの量 (ページングまたは非ページ) が高いか低い場合、システムは特定の標準イベント オブジェクトを自動的に設定します。 ドライバーは、これらのイベントがプールの使用状況を調整するのを待つことができます。 詳細については、「標準イベント オブジェクトのを する」を参照してください。

必要条件

関連項目

FSRTL_ADVANCED_FCB_HEADER

FsRtlFreeAePushLock

FsRtlSetupAdvancedHeaderEx2