capture 命令

捕获命令复制帧缓冲区的内容，并将其存储在指定的文件中。数字视频设备可识别此命令。

若要发送此命令，请使用 lpszCommand 参数集调用 mciSendString 函数，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
);

parameters

lpszDeviceID

MCI 设备的标识符。打开设备时会分配此标识符或别名。

lpszCapture

以下一个或多个标志：

值	含义
as pathname	指定捕获的图像的目标路径和文件名。需要此标记。
在矩形	指定设备裁剪并保存到磁盘的帧缓冲区中的矩形区域。如果省略，裁剪区域默认为此设备实例的上一个 put “source”命令上指定或默认的矩形。

lpszFlags

可以是“等待”、“通知”、“测试”或这些组合。有关这些标志的详细信息，请参阅等待、通知和测试标志。

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

如果设备当前正在播放动作视频或执行某些其他资源密集型操作，则此命令可能会失败。如果帧缓冲区正在实时更新，更新会暂时暂停，以便捕获完整的图像。如果设备暂停更新，可能会出现视觉或听觉效果。如果尚未设置文件格式、压缩算法和质量级别，则使用其默认值。

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