play 命令

播放命令會開始播放裝置。 CD 音訊、數位視訊、MIDI 排序器、videodisc、VCR 和電壓音訊裝置可辨識此命令。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

參數

lpszDeviceID

MCI 裝置的識別碼。 當裝置開啟時，會指派此識別碼或別名。

lpszPlayFlags

播放裝置的旗標。 下表列出可辨識 播放 命令的裝置類型，以及每種類型所使用的旗標。

值	意義	意義
cdaudio	從 位置	至 位置
digitalvideo	從 位置全螢幕重複	反轉至 位置視窗
排序器	從 位置	至 位置
錄影機	從位置反向時	掃描至 位置
videodisc	從 位置反向掃描快速	速度 緩慢的整數到 位置
waveaudio	從 位置	至 位置

下表列出可以在 lpszPlayFlags 參數及其意義中指定的旗標。

值	意義
時間	指出裝置何時應該開始執行此命令，或者當提示命令開始時，裝置是否已提示。 如需詳細資訊，請參閱 提示 命令。
快速	表示裝置應該比平常更快播放。 若要判斷視訊磁片播放機上的確切速度，請使用 status 命令的「速度」旗標。 若要更精確地指定速度，請使用此命令的「速度」旗標。
從 位置	指定播放的起始位置。 如果未指定 「from」 旗標，則播放會從目前的位置開始。 對於 cdaudio 裝置，如果「from」 位置大於磁片的結束位置，或如果 「from」 位置大於 「to」 位置，則驅動程式會傳回錯誤。 對於 videodisc 裝置，預設位置會位於 CAV 磁片的畫面中，以及 CLV 磁片的小時、分鐘和秒數。
全螢幕	指定應該使用全螢幕顯示。 只有在播放壓縮檔案時，才使用此旗標。 (未壓縮的檔案不會播放全螢幕。)
重複	指定達到內容結尾時應該重新開機播放。
reverse	指定播放方向向後。 您無法使用 「reverse」 旗標來指定結束位置。 若為 videodiscs，「掃描」僅適用于 CAV 格式。
scan	雖然音訊可能停用) ，但盡可能快速播放，但不會停用視訊 (。 若為 videodiscs，「掃描」僅適用于 CAV 格式。
slow	播放速度緩慢。 若要判斷視訊磁片播放機上的確切速度，請使用 status 命令的「速度」旗標。 若要更精確地指定速度，請使用此命令的「速度」旗標。 對於 videodiscs，「slow」 僅適用于 CAV 格式。
速度 整數	以每秒畫面為單位的指定速度播放視訊磁片。 此旗標僅適用于 CAV 磁片。
至 位置	指定播放的結束位置。 如果未指定 「to」 旗標，播放會在內容結尾停止。 若 為 cdaudio 裝置，如果 「to」 位置大於磁片的結束位置，驅動程式會傳回錯誤。 對於 videodisc 裝置，預設位置會位於 CAV 磁片的畫面中，以及 CLV 磁片的小時、分鐘和秒數。
時間範圍	指定播放應該使用與裝置實例相關聯的視窗。 這是預設值。

lpszFlags

可以是 「wait」、「notify」 或兩者。 對於數位視訊和 VCR 裝置，也可以指定「測試」。 如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

傳回值

如果成功或發生錯誤，則傳回零。

備註

發出使用位置值的命令之前，您應該使用 set 命令來設定所需的時間格式。 此命令會以目前的速度開始播放，如設定的「speed」 命令所設定。 如果指定 「reverse」 旗標，或將 「to」 旗標指定為小於 「from」 旗標的值，方向會反轉。 如果未指定 「from」 旗標，則播放會從目前的位置開始。 「to」 和 「reverse」 旗標不能一起使用。

範例

下列命令會在播放完成時，從位置 1000 到位置 2000 播放「mysound」 裝置，傳送通知訊息。

play mysound from 1000 to 2000 notify

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]

另請參閱

Mci

MCI 命令字串

提示

set