MCI_RECORD 命令

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

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

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

parameters

wDeviceID

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

dwFlags

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

lpRecord

指向 MCI_RECORD_PARMS 结构的指针。 具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

返回值

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

备注

使用 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)

另请参阅

Mci

MCI 命令