共用方式為


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

另請參閱

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer