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

此示例中的区域定义如下：

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]