seek 命令

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

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

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

參數

lpszDeviceID

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

lpszSeekFlags

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

下表列出可以在 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 [僅限傳統型應用程式]