record 命令

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

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

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

參數

lpszDeviceID

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

lpszRecordFlags

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

下表列出可在 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 [僅限桌面應用程式]