MCI_RECORD 命令

MCI_RECORD命令开始从当前位置或从一个指定位置到另一个指定位置进行录制。 VCR 和波形音频设备可识别此命令。尽管数字视频设备和 MIDI 序列器也识别此命令，但 MCIAVI 和 MCISEQ 驱动程序不会实现此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RECORD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_RECORD_PARMS) lpRecord
);

parameters

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

使用 MCI_GETDEVCAPS_CAN_RECORD 标志调用 MCI_GETDEVCAPS 命令时，返回 TRUE 的设备支持此命令。对于 MCIWAVE 驱动程序，如果文件在未保存的情况下关闭，则文件打开后记录的所有数据将被丢弃。

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

MCI_FROM: 起始位置包含在由 lpRecord 标识的结构的 dwFrom 成员中。分配给位置值的单位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 标志指定的。如果未指定MCI_FROM，则起始位置默认为当前位置。
MCI_RECORD_INSERT: 新记录的信息应插入或粘贴到现有数据中。某些设备可能不支持此功能。如果支持，则这是默认值。
MCI_RECORD_OVERWRITE: 数据应覆盖现有数据。 MCIWAVE。DRV 设备返回MCIERR_UNSUPPORTED_FUNCTION以响应此标志。
MCI_TO: 结束位置包含在由 lpRecord 标识的结构的 dwTo 成员中。分配给位置值的单位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 标志指定的。如果未指定MCI_TO，则结束位置默认为内容的末尾。

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

MCI_DGV_RECORD_AUDIO_STREAM: 音频流编号包含在由 lpRecord 标识的结构的 dwAudioStream 成员中。如果省略此标志，音频数据将记录到第一个物理流中。
MCI_DGV_RECORD_HOLD: 录制停止时，屏幕将保留最后一张图像，在发出 MCI_MONITOR 命令之前不会继续显示视频。
MCI_DGV_RECORD_VIDEO_STREAM: 视频流编号包含在由 lpRecord 标识的结构的 dwVideoStream 成员中。如果省略此标志，视频数据将记录到第一个物理流中。
MCI_DGV_RECT: 在由 lpRecord 标识的结构的 rc 成员中指定一个矩形。矩形指定用作压缩和保存像素源的外部输入的区域。此矩形默认为MCI_PUT命令MCI_DGV_PUT_VIDEO标志指定的 (或默认 ) 矩形。当它与视频矩形不同的设置时，显示的内容不是录制的内容

对于数字视频设备， lpRecord 指向 MCI_DGV_RECORD_PARMS 结构。

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

MCI_VCR_RECORD_AT: 由 lpRecord 标识的结构的 dwAt 成员包含整个命令开始的时间，或者如果设备被提示，则设备达到提示命令给定位置的时间。
MCI_VCR_RECORD_INITIALIZE: 将设备定位到媒体的开头，开始录制空白视频和音频，并尽可能录制时间码。

对于 VCR 设备， lpRecord 指向 MCI_VCR_RECORD_PARMS 结构。

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