VideoPortAllocatePool 函式 (video.h)

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 (包含 Video.h)
程式庫	Videoprt.lib
Dll	Videoprt.sys
IRQL	請參閱一節。

另請參閱

VideoPortFreePool