共用方式為


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

另請參閱

VideoPortAllocateCommonBuffer