MCI_PLAY 命令

MCI_PLAY命令指示设备开始传输输出数据。 CD 音频、数字视频、MIDI 序列器、视频磁盘、VCR 和波形音频设备可识别此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

parameters

wDeviceID

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

dwFlags

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

lpPlay

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

返回值

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

备注

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

MCI_FROM

起始位置包含在 lpPlay 标识的结构的 dwFrom 成员中。 分配给位置值的单位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 标志指定的。 如果未指定MCI_FROM,则起始位置默认为当前位置。

MCI_TO

结束位置包含在 lpPlay 标识的结构的 dwTo 成员中。 分配给位置值的单位是使用MCI_SET MCI_SET_TIME_FORMAT标志指定的。 如果未指定MCI_TO,则结束位置默认为媒体的末尾。

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

MCI_DGV_PLAY_REPEAT

当内容到达末尾时,播放应在开头重新开始。

MCI_DGV_PLAY_REVERSE

播放应反向进行。

MCI_MCIAVI_PLAY_WINDOW

播放应在与设备实例关联的窗口中进行, (默认) 。 (此标志特定于 MCIAVI。DRV.)

MCI_MCIAVI_PLAY_FULLSCREEN

播放应使用全屏显示。 仅在播放压缩文件或 8 位文件时使用此标志。

对于数字视频设备, lpPlay 指向 MCI_DGV_PLAY_PARMS 结构。

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

MCI_VCR_PLAY_AT

lpPlay 标识的结构的 dwAt 成员包含整个命令开始的时间,如果设备被提示,则设备到达 MCI_CUE 命令给定的位置。

MCI_VCR_PLAY_REVERSE

播放应反向进行。

MCI_VCR_PLAY_SCAN

播放应尽可能快,同时保持视频输出。

对于 VCR 设备, lpPlay 指向 MCI_VCR_PLAY_PARMS 结构。

以下附加标志用于 视频磁盘 设备类型:

MCI_VD_PLAY_FAST

快玩。

MCI_VD_PLAY_REVERSE

反向播放。

MCI_VD_PLAY_SCAN

快速扫描。

MCI_VD_PLAY_SLOW

播放缓慢。

MCI_VD_PLAY_SPEED

播放速度包含在 lpPlay 标识的结构中的 dwSpeed 成员中。

要求

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

另请参阅

Mci

MCI 命令