MCI_SAVE 命令

MCI_SAVE 命令保存当前文件。 修改文件的设备在收到保存消息之前不应销毁原始副本。 视频覆盖和波形音频设备可识别此命令。 尽管数字视频设备和 MIDI 序列器也识别此命令，但 MCIAVI 和 MCISEQ 驱动程序不会实现此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

参数

wDeviceID

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

dwFlags

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

lpSave

指向 MCI_SAVE_PARMS 结构的指针。 (具有其他参数的设备可能会将此结构替换为特定于设备的结构。)

返回值

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

备注

使用 MCI_GETDEVCAPS_CAN_SAVE 标志调用 MCI_GETDEVCAPS 命令时，返回 TRUE 的设备支持此命令。

以下附加标志适用于支持 MCI_SAVE的所有设备：

MCI_SAVE_FILE

由 lpSave 标识的结构的 lpfilename 成员包含包含目标文件名的缓冲区的地址。

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

MCI_DGV_RECT

由 lpSave 标识的 结构的 rc 成员包含有效的矩形。 矩形指定将保存到指定文件的帧缓冲区区域。 第一对坐标指定矩形的左上角;第二对指定宽度和高度。 数字视频设备必须使用 MCI_CAPTURE 命令来捕获帧缓冲区的内容。 (视频覆盖设备还应使用 MCI_CAPTURE.) 此标志是为了与现有的 MCI 视频覆盖命令集兼容。

MCI_DGV_SAVE_ABORT

停止正在进行的保存操作。 这必须是唯一存在的标志。

MCI_DGV_SAVE_KEEPRESERVE

不会解除分配原始 MCI_RESERVE 命令中剩余的未使用磁盘空间。

对于数字视频设备， lpSave 参数指向 MCI_DGV_SAVE_PARMS 结构。

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

MCI_OVLY_RECT

由 lpSave 标识的结构的 rc 成员包含一个有效的显示矩形，指示要保存的视频缓冲区的区域。

对于视频覆盖设备， lpSave 参数指向 MCI_OVLY_SAVE_PARMS 结构。

要求

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

另请参阅

Mci

MCI 命令