閱讀英文

共用方式為


seek 命令

seek 命令會移至指定的位置並停止。 CD 音訊、數位視訊、MIDI 排序器、VCR、videodisc 和電壓音訊裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
); 

參數

lpszDeviceID

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

lpszSeekFlags

移至指定位置的旗標。 下表列出可辨識 搜尋 命令的裝置類型,以及每種類型所使用的旗標。

意義 意義
cdaudio 到端對 位置 要啟動
digitalvideo 到端對 位置 要啟動
排序器 到端對 位置 要啟動
錄影機 時間標記mark_num反向 要開始的端對端位置
videodisc 反向至結尾 要開始的位置
waveaudio 到端對 位置 要啟動

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

意義
時間 指出裝置何時應該開始執行此命令,或者當提示命令開始時,裝置是否已提示。 如需詳細資訊,請參閱 提示 命令。
標示 mark_num 搜尋 mark_num所指示的相對標記,這必須是正整數值。 標記是使用 mark 命令寫入 VCR 磁帶的訊號,並用於高速搜尋。
reverse 指出 VCR 和 CAV 視訊discs 上的搜尋方向是回溯的。 如果指定了 「to」 旗標,則此旗標無效。 若為 VCR,此旗標必須搭配 「標記」旗標使用。
至結尾 搜尋內容結尾。
位置 指定要停止搜尋的位置。 針對 cdaudio 裝置,如果指定的位置大於磁片的長度,MCI 會傳回超出範圍的錯誤。
要啟動 搜尋內容開頭。

lpszFlags

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

傳回值

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

備註

發出任何使用位置值的命令之前,您應該使用 set 命令來設定所需的時間格式。

數位視訊裝置支援兩種搜尋模式,您可以使用 set 命令進行變更。 「完全搜尋」模式會導致搜尋命令移至指定的框架。 「搜尋完全關閉」模式會導致搜尋命令在指定的畫面格之前移至最接近的主要畫面格。

如果在發出搜尋命令時播放 CD 音訊裝置,則會停止播放。 當搜尋命令使用 videodisc 裝置發出時,裝置會使用快速轉寄或快速反向搜尋視訊和音訊關閉。

當搜尋命令以電壓音訊裝置發出時,行為取決於樣本大小。 如果樣本大小為 16 位或更大,當指定的位置與樣本開頭不一致時,搜尋會移至最接近樣本的開頭。

範例

下列命令會搜尋與 「mysound」 裝置相關聯的媒體檔案開頭。

seek mysound to start

規格需求

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

另請參閱

Mci

MCI 命令字串

提示

標記

set