保留命令

保留命令为设备实例的工作区分配连续磁盘空间。 数字视频设备可识别此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("reserve %s %s %s"), 
  lpszDeviceID, 
  lpszReserve, 
  lpszFlags
); 

参数

lpszDeviceID

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

lpszReserve

以下一个或多个标志。

含义
in path 指定驱动器和目录路径 (但指定用于保存记录数据的临时文件的名称) 。 此文件的名称由设备指定。 关闭设备时,将删除临时文件。 如果省略此标志,则设备将指定磁盘空间的位置。
大小 持续时间 指定要在工作区中保留的大致磁盘空间量。 持续时间值以当前时间格式指定。 设备基于以下参数估计所需磁盘空间:请求的时间、文件格式、视频和音频压缩算法以及有效压缩质量值。 如果 setvideo “record”为“off”,则仅为音频保留空间。 如果 setaudio “record”为“off”,则仅为视频保留空间。 如果两者都“关闭”,或者 持续时间 为零,则不保留任何空间,并且解除分配任何现有的保留空间。 如果省略此标志,则设备将使用设备定义的默认值。

lpszFlags

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

返回值

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

备注

如果需要,后续 记录保存 命令将使用此命令保留的空间。 如果工作区包含未保存的数据,则数据将丢失。 某些设备不需要保留并忽略它。 如果在录制之前未保留磁盘空间,则 record 命令会使用特定于设备的默认标志执行隐式保留。 如果希望更好地控制磁盘分配延迟的发生时间、控制分配的空间量以及分配磁盘空间的位置,请使用显式保留命令。 应用程序可以使用后续的保留命令更改以前保留的磁盘空间的数量和位置。 在保存任何记录的数据或关闭设备实例之前,不会解除分配任何已分配和仍然未使用的磁盘空间。

要求

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

另请参阅

Mci

MCI 命令字符串

record

保存

setaudio

setvideo