MCI_SEEK命令

MCI_SEEK命令會儘快變更內容中的目前位置。 搜尋期間會停用視訊和音訊輸出。 搜尋完成之後,裝置就會停止。 CD 音訊、數位視訊、MIDI Sequencer、VCR、videodisc 和電壓音訊裝置可辨識此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

參數

wDeviceID

要接收命令訊息之 MCI 裝置的裝置識別碼。

dwFlags

MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。 如需這些旗標的相關資訊,請參閱 等候、通知和測試旗標

lpSeek

MCI_SEEK_PARMS結構的指標。 (具有擴充命令集的裝置可能會將此結構取代為裝置特定的結構。)

傳回值

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

備註

如果裝置的資料樣本大小大於 1 個位元組 (,例如使用電壓音訊身歷聲資料) ,當指定的位置與樣本開頭不一致時,此命令會移至最接近樣本的開頭。

下列額外旗標適用于支援MCI_SEEK的所有裝置:

MCI_SEEK_TO_END

搜尋內容結尾。

MCI_SEEK_TO_START

搜尋內容的開頭。

MCI_TO

位置包含在lpSeek所識別結構的dwTo成員中。 指派給位置值的單位會以MCI_SET命令的 MCI_SET_TIME_FORMAT 旗標來指定。 請勿將此旗標與MCI_SEEK_TO_END或MCI_SEEK_TO_START搭配使用。

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

MCI_VCR_SEEK_AT

lpSeek所識別結構的dwAt成員包含整個命令開始的時間。

MCI_VCR_SEEK_MARK

lpSeek所識別結構的dwMark成員包含要搜尋的編號標記。

MCI_VCR_SEEK_REVERSE

搜尋方向為反向;這只適用于 MCI_VCR_SEEK_MARK 旗標。

若為 VCR 裝置, lpSeek 參數會指向 MCI_VCR_SEEK_PARMS 結構。

下列額外旗標會與 videodisc 裝置類型搭配使用:

MCI_VD_SEEK_REVERSE

搜尋方向為反向。

規格需求

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

另請參閱

Mci

MCI 命令