VideoPortAllocateCommonBuffer 函式 (video.h)
VideoPortAllocateCommonBuffer 函式會配置並對應系統記憶體,以便從處理器和裝置同時存取,以進行通用緩衝區 DMA 作業。
語法
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN PVP_DMA_ADAPTER VpDmaAdapter,
[in] IN ULONG DesiredLength,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[in] IN BOOLEAN CacheEnabled,
[out] OUT PVOID Reserved
);
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in] VpDmaAdapter
表示總線主要配接器之 VP_DMA_ADAPTER 結構的指標。 這個結構是由先前呼叫videoPortGetDmaAdapter 所傳回。
[in] DesiredLength
指定要求的記憶體位元組數目。
[out] LogicalAddress
記憶體位置的指標,該位置會接收配接器用來存取配置緩衝區的邏輯位址。
[in] CacheEnabled
指定是否可以快取配置的記憶體。 如需詳細資訊,請參閱 AllocateCommonBufferCacheEnabled 參數的描述。
[out] Reserved
目前視訊埠驅動程式會忽略;應該設定為 NULL。
傳回值
VideoPortAllocateCommonBuffer 如果成功,會傳回已配置緩衝區的基底虛擬位址;否則,如果無法配置緩衝區,它會傳回 NULL。
言論
不再需要緩衝區時,視訊迷你埠驅動程序應該呼叫 VideoPortReleaseCommonBuffer來釋放它。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows XP 和更新版本的 Windows作系統。 |
目標平臺 | 桌面 |
標頭 | video.h (include Video.h) |
連結庫 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |