FltAllocatePoolAlignedWithTag 函式 （fltkernel.h）
FltAllocatePoolAlignedWithTag 配置裝置對齊的緩衝區，以用於非快取 I/O 作業。
語法
PVOID FLTAPI FltAllocatePoolAlignedWithTag(
[in] PFLT_INSTANCE Instance,
[in] POOL_TYPE PoolType,
[in] SIZE_T NumberOfBytes,
[in] ULONG Tag
);
參數
[in] Instance
附加至磁碟區的呼叫端擁有迷你篩選驅動程序實例的不透明實例指標。 這是必要參數，而且無法 NULL。
[in] PoolType
要配置的集區類型。 下列其中一項：
NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned
如需可用集區內存類型的描述，請參閱 POOL_TYPE。
[in] NumberOfBytes
要配置的位元元組數目。 這個參數是必要的，而且可以是零。
[in] Tag
指定配置記憶體的集區標記。 驅動程式通常會將集區標記指定為一到四個 7 位 ASCII 字元的字串，並以單引號分隔（例如 'abcd'）。 這是必要參數，不能為零。
傳回值
如果沒有足夠的可用集區來滿足要求，FltAllocatePoolAlignedWithTag 會傳回 NULL 指標。 否則，FltAllocatePoolAlignedWithTag 會傳回新配置的緩衝區指標。
言論
FltAllocatePoolAlignedWithTag 會根據指定磁碟區的基礎裝置來配置緩衝區。 非快取 I/O 需要這類裝置對齊的緩衝區。 （它們也可用於快取的 I/O。因此，呼叫執行非快取 I/O 的例程時，例如 FltReadFile 和 FltWriteFile，迷你篩選驅動程式應該呼叫 FltAllocatePoolAlignedWithTag，而不是 ExAllocatePoolWithTag。
如果呼叫端針對 NumberOfBytes 參數指定零的值，FltAllocatePoolAlignedWithTag 配置符合對齊需求的最小內存量。
系統會將 Tag 參數所指定的集區標記與配置的緩衝區產生關聯。 Windows 調試程式 （WinDbg） 等程式設計工具可以顯示與每個已配置緩衝區相關聯的集區標記。 集區標籤的值通常會以反向順序顯示。 例如，如果呼叫端傳遞 『Fred』 做為 Tag 參數的值，則如果傾印集區，或追蹤調試程式中的集區使用量時，這個值會顯示為 『derF』。
如需記憶體管理的詳細資訊，請參閱 記憶體管理。
當不再需要 FltAllocatePoolAlignedWithTag 配置的緩衝區時，呼叫者會負責呼叫 FltFreePoolAlignedWithTag來釋放它。
只有在指定 NonPagedXxxPoolType 時，才能在 IRQL DISPATCH_LEVEL 執行 FltAllocatePoolAlignedWithTag 的呼叫者。 否則，呼叫端必須在 IRQL <= APC_LEVEL執行。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | fltkernel.h （包括 Fltkernel.h） |
| 連結庫 | FltMgr.lib |
| IRQL | <= APC_LEVEL （請參閱一節） |