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 [僅限傳統型應用程式] |