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 [仅限桌面应用] |
标头 |
|