MCI_PUT 命令

  • 项目

MCI_PUT 命令设置源矩形、目标矩形和框架矩形。 数字视频和视频覆盖设备可识别此命令。

若要发送此命令，请使用以下参数调用 mciSendCommand 函数。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

参数

wDeviceID

要接收命令消息的 MCI 设备的设备标识符。

dwFlags

MCI_NOTIFY、MCI_WAIT，或者，对于数字视频设备，MCI_TEST。 有关这些标志的信息，请参阅 等待、通知和测试标志。

lpDest

指向 MCI_GENERIC_PARMS 结构的指针。 具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

返回值

如果成功，则返回零，否则返回错误。

备注

以下附加标志用于 数字视频 设备类型：

MCI_DGV_PUT_CLIENT

为 MCI_DGV_RECT 定义的矩形适用于客户端窗口的位置。 指定的矩形相对于显示窗口的父窗口。 MCI_DGV_PUT_WINDOW必须在此标志的同时设置。

MCI_DGV_PUT_DESTINATION

为 MCI_DGV_RECT 定义的矩形指定目标矩形。 目标矩形指定与此设备驱动程序实例关联的客户端窗口部分，该实例显示图像或视频。

MCI_DGV_PUT_FRAME

为 MCI_DGV_RECT 定义的矩形适用于框架矩形。 框架矩形指定用作从视频矩形获取的视频图像的目标的帧缓冲区部分。 应缩放视频以适应帧缓冲区矩形。

矩形在帧缓冲区坐标中指定。 默认矩形是全帧缓冲区。 指定此矩形可使设备在数字化数据时缩放图像。 无法缩放映像的设备使用 MCIERR_UNSUPPORTED_FUNCTION 拒绝此命令。 可以将 MCI_GETDEVCAPS_CAN_STRETCH 标志与 MCI_GETDEVCAPS 命令一起使用，以确定设备是否缩放映像。 如果设备无法缩放映像，则返回 FALSE 。

MCI_DGV_PUT_SOURCE

为 MCI_DGV_RECT 定义的矩形指定源矩形。 源矩形指定要缩放帧缓冲区的哪一部分以适应目标矩形。

MCI_DGV_PUT_VIDEO

为MCI_DGV_RECT定义的矩形适用于视频矩形。 视频矩形指定当前演示文稿源的哪一部分存储在帧缓冲区中。 矩形是使用演示源的自然坐标指定的。 它允许指定在帧缓冲区中存储图像和视频之前发生的裁剪。 默认矩形是完全活动扫描区域或完全解压缩的图像和视频。

MCI_DGV_PUT_WINDOW

为MCI_DGV_RECT定义的矩形适用于显示窗口。 此矩形相对于显示窗口的父窗口 (通常是桌面) 。 如果未指定窗口，则默认为初始窗口大小和位置。

MCI_DGV_RECT

由 lpDest 标识的结构的 rc 成员包含有效的矩形。

对于数字视频设备， lpDest 指向 MCI_DGV_PUT_PARMS 结构。

以下附加标志用于 覆盖 设备类型：

MCI_OVLY_PUT_DESTINATION

为 MCI_OVLY_RECT 定义的矩形指定用于显示图像的客户端窗口区域。 矩形包含图像相对于窗口原点的偏移量和可见范围。 如果正在拉伸框架，则会将源拉伸到目标矩形。

MCI_OVLY_PUT_FRAME

为 MCI_OVLY_RECT 定义的矩形指定用于接收视频图像的视频缓冲区的区域。 矩形包含相对于视频缓冲区原点的缓冲区区域的偏移量和范围。

MCI_OVLY_PUT_SOURCE

为 MCI_OVLY_RECT 定义的矩形指定用作数字图像源的视频缓冲区区域。 矩形包含视频缓冲区相对于其原点的剪切矩形的偏移量和范围。

MCI_OVLY_PUT_VIDEO

为 MCI_OVLY_RECT 定义的矩形指定视频缓冲区捕获的视频源区域。 矩形包含视频源相对于其原点的剪切矩形的偏移量和范围。

MCI_OVLY_RECT

由 lpDest 标识的结构的 rc 成员包含有效的显示矩形。 如果未指定此标志，则默认矩形将匹配正在剪辑的视频缓冲区或窗口的坐标。

对于视频覆盖设备， lpDest 指向 MCI_OVLY_RECT_PARMS 结构。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Mmsystem.h (包括 Windows.h)

另请参阅

Mci

MCI 命令