videoPortGetCommonBuffer 函式 (video.h)
VideoPortGetCommonBuffer 函式在 Windows XP 和更新版本中已過時,而且僅支援與現有驅動程式的回溯相容性。 驅動程式寫入器應該使用 VideoPortAllocateCommonBuffer。
VideoPortGetCommonBuffer 會配置和對應系統記憶體,以便同時從處理器和裝置存取,以進行通用緩衝區 DMA 作業。
語法
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG DesiredLength,
[in] IN ULONG Alignment,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[out] OUT PULONG pActualLength,
[in] IN BOOLEAN CacheEnabled
);
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in] DesiredLength
指定要求的記憶體位元組數目。
[in] Alignment
指定緩衝區的要求對齊方式。 視訊埠驅動程式目前會忽略此參數。
[out] LogicalAddress
接收配接器用來存取配置緩衝區之邏輯位址的變數指標。
[out] pActualLength
變數的指標,該變數會接收為這個要求配置之緩衝區的實際大小,以位元組為單位。
[in] CacheEnabled
指定是否可以快取配置的記憶體。
傳回值
VideoPortGetCommonBuffer 會在成功時傳回已配置緩衝區的基底虛擬位址;否則,如果無法配置緩衝區,則會傳回 NULL 。
備註
如需封包型和通用緩衝區 DMA 傳輸的相關信息,請參閱 Video Miniport Drivers 中的 Bus-Master DMA。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
目標平台 | 桌面 |
標頭 | video.h (包含 Video.h) |
程式庫 | Videoprt.lib |
Dll | Videoprt.sys |
IRQL | PASSIVE_LEVEL |