MCI_PLAY 命令

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

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

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

参数

wDeviceID

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

dwFlags

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

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,则结束位置默认为媒体的末尾。

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

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 结构。

以下附加标志与 videodisc 设备类型一起使用:

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 命令