save 命令

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

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

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

参数

lpszDeviceID

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

lpszFilename

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

含义 含义
digitalvideo 矩形处中止 filenamekeepreserve
overlay 矩形 filename
sequencer filename
waveaudio filename

下表列出了可在 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 [仅限桌面应用]

另请参阅

Mci

MCI 命令字符串

捕获

保留