VideoPortCompleteDma 函数 (video.h)

  • 项目

VideoPortCompleteDma 函数在 DMA 传输操作结束时刷新总线主适配器的内部缓存中剩余的任何数据，然后释放之前分配的映射寄存器和散点/收集 DMA 操作中使用的散点/收集列表。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCompleteDma(
  [in] IN PVOID                   HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER         VpDmaAdapter,
  [in] IN PVP_SCATTER_GATHER_LIST VpScatterGather,
  [in] IN BOOLEAN                 WriteToDevice
);

参数

[in] HwDeviceExtension

指向微型端口驱动程序的设备扩展的指针。

[in] VpDmaAdapter

指向表示总线主适配器 的VP_DMA_ADAPTER 结构的指针。 此结构是通过调用 VideoPortGetDmaAdapter 返回的。

[in] VpScatterGather

指向先前传递给微型端口驱动程序回调例程 HwVidExecuteDma的VP_SCATTER_GATHER_LIST结构的指针。

[in] WriteToDevice

指定 DMA 传输的方向。 值为 TRUE 表示从缓冲区传输到设备，值为 FALSE 表示从设备到缓冲区的传输。

返回值

VideoPortCompleteDma 返回NO_ERROR。

注解

完成 DMA 传输后，视频微型端口驱动程序应立即调用 VideoPortCompleteDma 以释放系统资源。

请务必注意，当调用 VideoPortCompleteDma 时，VideoPortStartDma 生成的散点/收集列表将变为无效。

要求

要求 值
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL <=DISPATCH_LEVEL

另请参阅

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma