put 命令
put 命令定义用于显示的源图像和目标窗口的区域。 数字视频和视频覆盖设备可识别此命令。
若要发送此命令,请使用 lpszCommand 参数集调用 mciSendString 函数,如下所示。
_stprintf_s(
lpszCommand,
TEXT("put %s %s %s"),
lpszDeviceID,
lpszRegions,
lpszFlags
);
-
lpszDeviceID
-
MCI 设备的标识符。 打开设备时会分配此标识符或别名。
-
lpszRegions
-
用于定义区域的标志。 下表列出了可识别 put 命令的设备类型以及每种类型使用的标志。
值 含义 含义 digitalvideo 矩形框架中矩形源源位于矩形的矩形框架中的目标目标 视频视频在矩形窗口窗口矩形窗口客户端窗口客户端在矩形窗口 overlay 目标目标位于矩形的矩形框架框架处 源源在矩形视频视频在矩形处 下表列出了可在 lpszRegions 参数中指定的标志及其含义。
值 含义 destination 选择目标窗口的整个工作区以显示数据。 目标位于矩形处 选择用于显示图像的目标窗口工作区的一部分。 当指定显示窗口的区域并且设备支持拉伸时,源图像将拉伸到目标偏移量和范围。 框架 选择用于接收传入视频图像的整个帧缓冲区。 矩形处的框架 选择帧缓冲区的一部分来接收传入的视频图像。 source 选择要在目标窗口中显示的整个图像。 源位于矩形处 选择要在目标窗口中显示的图像的一部分。 如果指定了源图像的区域,并且设备支持拉伸,则源图像将拉伸到目标偏移量和范围。 视频 选择要在帧缓冲区中捕获的整个传入视频图像。 矩形处的视频 选择要在帧缓冲区中捕获的传入视频图像的一部分。 window 还原显示器上的初始窗口大小。 此命令还会显示窗口。 矩形处的窗口 更改显示窗口的大小和位置。 指定的矩形相对于显示窗口的父窗口 (通常桌面) 如果“style child”标志已用于 打开 命令。 若要更改窗口的位置而不更改其高度或宽度,请为高度和宽度指定零。 窗口客户端 还原窗口的工作区。 矩形处的窗口客户端 更改窗口工作区的大小和位置。 指定的矩形相对于客户端窗口的父窗口。 若要更改窗口的位置而不更改其高度或宽度,请为高度和宽度指定零。 当标志包含矩形时,矩形坐标是相对于窗口原点或图像原点(视情况而定)的,并指定为 X1 Y1 X2 Y2。 坐标 X1Y1 指定左上角,坐标 X2Y2 指定矩形的宽度和高度。
-
lpszFlags
-
可以是“等待”、“通知”或两者。 对于数字视频设备,还可以指定“测试”。 有关这些标志的详细信息,请参阅 等待、通知和测试标志。
如果成功,则返回零,否则返回错误。
使用视频覆盖设备时,put 命令定义以下一个或多个矩形:
- 视频矩形定义要捕获的传入视频图像的区域。
- 帧矩形定义接收传入视频图像的帧缓冲区的区域。
- 源矩形定义将帧缓冲区的哪个区域复制到目标矩形。
- 目标矩形定义接收视频图像的显示窗口工作区的区域。
视频矩形与框架矩形相关,其方式与源矩形与目标矩形相关的方式相同。 从视频矩形到框架矩形以及从源矩形到目标矩形,都可能发生拉伸。 并非所有设备都支持拉伸,并且必须使用 set 命令) 启用拉伸 (。
以下命令定义视频、帧和源的三个区域。
put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200
此示例中的区域定义如下:
- 传入视频数据的 200 x 200 像素区域(从左上角 120 像素的原点开始)将捕获到帧缓冲区。
- 视频数据将放置在帧缓冲区左上角的 200 x 200 像素区域中。
- 从帧缓冲区左上角的 200 x 200 像素区域传输到目标窗口。
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |