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 [僅限桌面應用程式] |
標頭 |
|