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 (波浪) 。 每個配置程式代碼路徑都應該使用唯一的集區標籤，協助調試程式和驗證程式識別程式代碼路徑。
傳回值
如果可用集區中的記憶體不足，FsRtlAllocateAePushLock 會傳回 NULL，以滿足要求。 否則，例程會傳回已配置和初始化之自動展開推播鎖定的指標。
備註
FsRtlAllocateAePushLock 可用來為自動展開的推送鎖定配置集區內存。 如需自動展開推播鎖定的詳細資訊 ，請參閱FSRTL_ADVANCED_FCB_HEADER 。
系統會將集區標籤與配置的記憶體產生關聯。 WinDbg 之類的程式設計工具可以顯示與每個配置緩衝區相關聯的集區標籤。 Gflags 是 Windows 偵錯 工具中包含的工具，會開啟系統功能，要求從 特殊集 區配置特定集區標記。 Poolmon 包含在 WDK 中，會依集區標籤追蹤記憶體。
FsRtlAllocateAePushLock 的呼叫端後續必須呼叫 FsRtlFreeAePushLock 以釋放配置的自動展開推播鎖定。
當集區數量 (分頁或非分頁) 高或低時，系統會自動設定特定標準事件物件。 驅動程式可以等候這些事件調整其集區使用量。 如需詳細資訊，請參閱 標準事件物件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 20H2 |
| 標頭 | ntifs.h |
| IRQL | <= APC_LEVEL |