record 命令

記錄命令會開始錄製資料。 VCR 和電壓音訊裝置可辨識此命令。 雖然數位視訊裝置和 MIDI 排序器也辨識此命令,但 MCIAVI 和 MCISEQ 驅動程式不會實作它。

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

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

參數

lpszDeviceID

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

lpszRecordFlags

記錄資料的旗標。 下表列出可辨識 記錄 命令的裝置類型,以及每種類型所使用的旗標。

值 意義 意義
digitalvideo 位於矩形音訊串流串流的位置保留 插入覆寫以 定位視訊 串流
排序器 從 位置插入 覆寫至 位置
錄影機 從位置初始化時 插入覆寫至 位置
waveaudio 從 位置插入 覆寫至 位置

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

值 意義
矩形 指定外部輸入的矩形區域,做為壓縮和儲存的圖元來源。 如果未指定,矩形會預設為針對 put 「video」 指定的矩形。 當它與「視訊」矩形設定不同時,顯示的影像不是錄製的內容。
時間 指出裝置何時應該開始執行此命令,或者,如果裝置已提示,則為提示命令開始時。 如需詳細資訊,請參閱 提示 命令。
音訊資料流程 資料流程 指定用於錄製的音訊資料流程。 如果未指定此旗標,而且檔案格式未定義預設值,則會記錄到實際第一個資料流程中。
從 位置 指定錄製的開始位置。 如果未指定 「寄件者」旗標,裝置就會開始在目前的位置錄製。
hold 錄製完成時凍結影像,而不是顯示即時影片。 錄製停止時,會執行自動 監視 「檔案」命令。 若要返回即時影片,請發出 監視器 「輸入」命令。
initialize 初始化磁帶 (媒體) ,這牽涉到視訊和音訊的可能) 錄製時碼 (。 如果必須初始化整個磁帶,此命令可能需要數小時的時間。
insert 指定將新資料新增至目前位置的檔案。
overwrite 指定新資料將會取代檔案中的資料。
至 位置 指定錄製的結束位置。 如果未指定 「to」 旗標,裝置會記錄直到收到 停止 或 暫停 命令為止。
視訊 串流串流 指定用於錄製的視訊串流。 如果未指定,而且檔案格式未定義預設值,則會先記錄到實際執行的資料流程中。

lpszFlags

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

傳回值

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

備註

發出 停止 或 暫停 命令時,錄製會停止。 針對 MCIWAVE 驅動程式,如果關閉檔案而不儲存檔案,則會捨棄在檔案開啟之後記錄的所有資料。

發出任何使用位置值的命令之前,您應該使用 set 命令來 設定 所需的時間格式。 要錄製的曲目是由 settimecode 「record」、set 「assemble record」、「 setvideo 」record「 和 setaudio 」record「 命令所指定。

範例

下列命令會開始在目前的位置錄製。

record mysound

規格需求

需求 值
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]

另請參閱

Mci

MCI 命令字串

提示

monitor

pause

把

set

setaudio

settimecode

setvideo

停止