DD_DXAPI_OPENVPCAPTUREDEVICE控制代码

  • 项目

视频捕获驱动程序在 DxApi 函数的 dwFunctionNum 参数中传递DD_DXAPI_OPENVPCAPTUREDEVICE，以打开设备进行视频捕获。

输入参数

输出参数

注解

VPE 捕获设备允许将硬件视频端口数据从图面自动总线母带到指定的缓冲区。 打开捕获设备确定要捕获的行。 例如，对于 VBI，捕获驱动程序可能只对前 21 行感兴趣。 如果捕获驱动程序想要将不同的区域捕获到不同的缓冲区， (例如，VBI 和视频将不同的缓冲区捕获到) ，则可以创建多个捕获设备。

创建捕获设备时，内核模式视频传输会为每个设备创建一个队列。 驱动程序稍后可以将缓冲区添加到此队列。 每次发生硬件视频端口 V 同步时，内核模式视频传输都会从最近由硬件视频端口填充的帧缓冲区图面自动启动正确的总线主机到队列中的缓冲区。 如果不想捕获每个字段，可以通过将 DDOPENVPCAPTUREDEVICEIN 的 dwCaptureEveryNFields 成员设置为 1 以外的值来指示这一点。

DDOPENVPCAPTUREDEVICEIN 的 hDirectDraw 和 hVideoPort 成员指定要从中捕获的 DirectDraw 对象和 VPE 对象。 dwStartLine 和 dwEndLine 成员指示要捕获的行。 dwStartLine 成员相对于图面的开头 (0 是第一行) 且 dwEndLine 是包含的， (将 dwStartLine 和 dwEndLine 设置为 0 会导致) 捕获第一行。

驱动程序还必须指定在捕获设备由于 VPE 对象在用户模式下释放而不可用时调用的回调。 DDOPENVPCAPTUREDEVICEIN 的 pContext 成员包含一个在调用 pfnCaptureClose 回调函数时传递的值。

如果 DDOPENVPCAPTUREDEVICEOUT 的 ddRVal 成员设置为 DD_OK，则此函数标识符的输出是新的 DirectDraw 捕获句柄。 此新句柄必须用于引用此捕获设备的所有后续调用。

此函数标识符只能从PASSIVE_LEVEL调用。

要求

标头

 Ddkmapi.h (包括 Ddkmapi.h)

另请参阅

DDOPENVPCAPTUREDEVICEIN

DDOPENVPCAPTUREDEVICEOUT

NotifyCallback