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 |