save 命令

save 命令保存 MCI 文件。视频覆盖和波形音频设备可识别此命令。尽管数字视频设备和 MIDI 排序器也识别此命令，但 MCIAVI 和 MCISEQ 驱动程序不支持它。

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

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
);

参数

lpszDeviceID

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

lpszFilename

指定要保存的文件的名称的标志以及（可选）修改保存操作的其他标志。下表列出了可识别保存命令的设备类型以及每种类型使用的标志。

下表列出了可在 lpszFilename 参数中指定的标志及其含义。

值	含义
abort	停止正在进行的保存操作。如果使用，则必须是唯一存在的项。
在矩形	指定相对于帧缓冲区原点的矩形。矩形指定为 X1 Y1 X2 Y2。坐标 X1 Y1 指定左上角，坐标 X2 Y2 指定宽度和高度。对于数字视频设备，捕获命令用于捕获帧缓冲区的内容。
filename	指定要分配给数据文件的文件名。如果未指定路径，则文件将放在磁盘上，以及之前在显式或隐式保留命令中指定的目录中。如果尚未发出保留，则默认驱动器和目录是与应用程序任务关联的驱动器和目录。如果指定了路径，设备可能要求它位于显式或隐式保留指定的磁盘驱动器上。需要此标记。
keepreserve	指定未解除分配原始保留命令中剩余的未使用磁盘空间。

lpszFlags

可以是“等待”、“通知”或两者。对于数字视频和 VCR 设备，还可以指定“测试”。有关这些标志的详细信息，请参阅等待、通知和测试标志。

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

如果使用“新”设备标识符打开设备，则需要 文件名 变量。

以下命令将整个视频缓冲区保存到名为 VCAPFILE 的文件。Tga。

save vboard c:\vcap\vcapfile.tga

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