MCI_CUE命令

MCI_CUE命令會提示裝置，讓播放或錄製以最小延遲開始。數位視訊、VCR 和電壓音訊裝置可辨識此命令。

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

參數

wDeviceID: 要接收命令訊息之 MCI 裝置的裝置識別碼。
dwFlags: MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。如需這些旗標的相關資訊，請參閱等候、通知和測試旗標。
lpCue: MCI_GENERIC_PARMS結構的指標。 (具有擴充命令集的裝置可能會將此結構取代為裝置特定的結構。)

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

下列額外的旗標會與 digitalvideo 裝置類型搭配使用：

MCI_DGV_CUE_INPUT: 數位視訊實例應該準備錄製。如果應用程式沒有保留磁碟空間，裝置會使用其預設參數來保留磁碟空間。如果目前的簡報來源已經是外部輸入，應用程式可以省略此旗標。 (此旗標不會影響選取簡報 source.)
MCI_DGV_CUE_NOSHOW: 數位視訊實例應該準備使用命令來播放指定的畫面，而不顯示它。指定此旗標時，即使其對應的畫面不是目前的位置，顯示器仍會繼續在畫面緩衝區中顯示影像。例如，如果畫面緩衝區包含畫面 7 中的影像，當此旗標用來提示裝置到任何其他位置時，裝置會繼續顯示畫面 7。沒有這個旗標且沒有MCI_TO旗標的後續提示命令會顯示目前的框架。
MCI_DGV_CUE_OUTPUT: 數位視訊實例應該準備播放。如果工作區已暫停，則不會發生任何位置。如果工作區已停止，位置可能會變更為先前的主要畫面格影像。如果目前的簡報來源已經是工作區，應用程式可以省略此旗標。
MCI_TO: 工作區位置包含在lpCue所識別結構的dwTo成員中。指派給位置值的單位是使用 MCI_SET 命令的 MCI_SET_TIME_FORMAT 旗標來指定。這相當於搜尋位置，但裝置在命令之後暫停。

對於 digitalvideo 裝置， lpCue 參數會指向 MCI_DGV_CUE_PARMS 結構。

下列額外的旗標會搭配 vcr 裝置類型使用：

MCI_FROM: lpCue所指向結構的dwFrom成員包含目前時間格式所指定的開始位置。
MCI_TO: lpCue所指向結構的dwTo成員包含以目前時間格式指定的結束 (暫停) 位置。
MCI_VCR_CUE_INPUT: 準備錄製。
MCI_VCR_CUE_OUTPUT: 準備播放。如果未指定MCI_VCR_CUE_INPUT或MCI_VCR_CUE_OUTPUT，則會假設MCI_VCR_CUE_OUTPUT。
MCI_VCR_CUE_PREROLL: 將裝置提示到目前的位置，或 dwFrom 位置減去預先註冊持續時間。這可讓裝置在進入記錄或播放模式之前自行準備。
MCI_VCR_CUE_REVERSE: 下一個播放或錄製命令的方向是反向的。

當提示使用具有 MCI_VCR_CUE_OUTPUT 旗標的 MCI_CUE 命令進行播放時，您可以發出具有 MCI_FROM、MCI_TO 或 MCI_VCR_PLAY_REVERSE 的 MCI_PLAY 命令來取消MCI_CUE。

當提示使用 MCI_CUE 搭配 MCI_VCR_CUE_INPUT 旗標來錄製時，您可以發出具有 MCI_FROM、MCI_TO 或 MCI_VCR_RECORD_INITIALIZE 的 MCI_RECORD 命令來取消MCI_CUE。

對於 vcr 裝置， lpCue 參數會指向 MCI_VCR_CUE_PARMS 結構。

下列額外的旗標會與 waveaudio 裝置類型搭配使用：

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Mmsystem.h (包含 Windows.h)