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