VideoPortAllocatePool 函式會配置集區內存區塊，並在記憶體開頭插入呼叫端提供的標記。
語法
VIDEOPORT_API PVOID VideoPortAllocatePool(
[in] IN PVOID HwDeviceExtension,
[in] IN VP_POOL_TYPE PoolType,
[in] IN SIZE_T NumberOfBytes,
[in] IN ULONG Tag
);
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in] PoolType
指定要配置的記憶體集區類型。 此參數可以設定為下列其中一項：
| 價值 | 意義 |
|---|---|
| VpNonPagedPool | 集區來自非分頁記憶體。 |
| VpPagedPool | 集區來自分頁記憶體。 |
| VpNonPagedPoolCacheAligned | 集區來自快取對齊的非分頁記憶體。 |
| VpPagedPoolCacheAligned | 集區來自快取對齊的分頁記憶體。 |
[in] NumberOfBytes
指定要配置的記憶體位元組數目。
[in] Tag
指定由最多四個 ASCII 字元組成的四位元組配置標記，可唯一識別配置記憶體的驅動程式。 標記字串是以單引號分隔。
傳回值
成功配置記憶體集區時，VideoPortAllocatePool 會傳回已配置記憶體集區的位址。 否則，此函式會傳回NULL 。
言論
VideoPortAllocatePool 的目的是取代 VideoPortAllocateBuffer，這是過時的。
標記 字串應該以位元組反轉的順序指定。 建議字串中的第一個字母 （反轉之前） 為 『D』 來表示顯示驅動程式;其他三個字節應該表示驅動程序名稱。 例如，如果傾印集區，標記 字串串 'zyxD' 會顯示為 'Dxyz'。 標記會出現在發生之系統的任何損毀傾印中。
VideoPortAllocatePool 的呼叫者只能在 IRQL = DISPATCH_LEVEL執行，只有當要求的 PoolType 是其中一個 VpNonPagedXxx 類型時。 否則，呼叫端必須在 IRQL < DISPATCH_LEVEL 執行。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows XP 和更新版本的 Windows作系統。 |
| 目標平臺 | 桌面 |
| 標頭 | video.h （include Video.h） |
| 連結庫 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | 請參閱一節。 |