FsRtlAllocateAePushLock 函式 （ntifs.h）

FsRtlAllocateAePushLock 配置並初始化自動展開的推送鎖定。

語法

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

參數

[in] PoolType

要配置給自動展開推送鎖定的集區內存類型。 如需可用集區內存類型的描述，請參閱 POOL_TYPE。 您可以使用 POOL_RAISE_IF_ALLOCATION_FAILURE 旗標來修改 PoolType 值。 如果無法滿足配置要求，此旗標會導致引發例外狀況。

[in] Tag

要用於已配置記憶體的集區標籤。 將集區標記指定為以單引號分隔之一到四個字元的非零字元常值（例如 'Tag1'）。 字串通常會以反向順序指定（例如 '1gaT'）。 標記中的每個 ASCII 字元都必須是範圍0x20（空格）中的值，才能0x7E（tilde）。 每個配置程式代碼路徑都應該使用唯一的集區標記來協助調試程式和驗證程式識別程式代碼路徑。

傳回值

FsRtlAllocateAePushLock 如果可用集區中的記憶體不足而無法滿足要求，則會傳回 NULL。 否則，例程會傳回已配置和初始化之自動展開推送鎖定的指標。

言論

FsRtlAllocateAePushLock 可用來配置集區內存以進行自動展開推入鎖定。 如需自動展開推送鎖定的詳細資訊，請參閱 FSRTL_ADVANCED_FCB_HEADER。

系統會將集區標籤與配置的記憶體產生關聯。 程序設計工具，例如 WinDbg，可以顯示與每個配置緩衝區相關聯的集區標記。 Gflags，這是 Windows偵錯工具中包含的工具，會開啟要求特定 集區標記 特殊集區配置的系統功能。 Poolmon，其包含在 WDK 中，會依集區卷標追蹤記憶體。

FsRtlAllocateAePushLock 的呼叫者必須接著呼叫 FsRtlFreeAePushLock，以釋放配置的自動展開推入鎖定。

當集區數量（分頁或非分頁）為高或低時，系統會自動設定特定標準事件物件。 驅動程式可以等候這些事件調整其集區使用量。 如需詳細資訊，請參閱 標準事件物件。

要求

另請參閱

FSRTL_ADVANCED_FCB_HEADER

FsRtlFreeAePushLock

FsRtlSetupAdvancedHeaderEx2