MCI_RECORD命令

MCI_RECORD命令會開始從目前位置或從一個指定位置錄製到另一個指定位置。 VCR 和電壓音訊裝置可辨識此命令。雖然數位視訊裝置和 MIDI 排序器也辨識此命令，但 MCIAVI 和 MCISEQ 驅動程式不會實作它。

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RECORD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_RECORD_PARMS) lpRecord
);

參數

wDeviceID: 要接收命令訊息之 MCI 裝置的裝置識別碼。
dwFlags: MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。如需這些旗標的相關資訊，請參閱等候、通知和測試旗標。
lpRecord: MCI_RECORD_PARMS結構的指標。 (具有擴充命令集的裝置可能會將此結構取代為裝置特定的結構。)

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

當您使用 MCI_GETDEVCAPS_CAN_RECORD 旗標呼叫MCI_GETDEVCAPS命令時，傳回TRUE的裝置支援此命令。針對 MCIWAVE 驅動程式，如果關閉檔案而不儲存檔案，則會捨棄在檔案開啟之後記錄的所有資料。

下列其他旗標適用于支援MCI_RECORD的所有裝置：

MCI_FROM: 開始位置包含在lpRecord所識別結構的dwFrom成員中。指派給位置值的單位會以MCI_SET命令的 MCI_SET_TIME_FORMAT 旗標來指定。如果未指定MCI_FROM，起始位置會預設為目前的位置。
MCI_RECORD_INSERT: 新記錄的資訊應該插入或貼到現有的資料中。某些裝置可能不支援此功能。如果支援，這是預設值。
MCI_RECORD_OVERWRITE: 資料應該覆寫現有的資料。 MCIWAVE。DRV 裝置會傳回MCIERR_UNSUPPORTED_FUNCTION以回應此旗標。
MCI_TO: 結束位置包含在lpRecord所識別結構的dwTo成員中。指派給位置值的單位會以MCI_SET命令的 MCI_SET_TIME_FORMAT 旗標來指定。如果未指定MCI_TO，結束位置會預設為內容結尾。

下列額外的旗標會與 digitalvideo 裝置類型搭配使用：

MCI_DGV_RECORD_AUDIO_STREAM: 音訊資料流程編號會包含在lpRecord所識別結構的dwAudioStream成員中。如果您省略此旗標，音訊資料會記錄到第一個實體資料流程中。
MCI_DGV_RECORD_HOLD: 錄製停止時，畫面會保留最後一個影像，且在發出 MCI_MONITOR 命令之前不會繼續顯示視訊。
MCI_DGV_RECORD_VIDEO_STREAM: 視訊串流編號包含在lpRecord所識別結構的dwVideoStream成員中。如果您省略此旗標，影片資料會錄製到第一個實體資料流程中。
MCI_DGV_RECT: 矩形是在lpRecord所識別結構的rc成員中指定。矩形會指定做為壓縮和儲存圖元來源的外部輸入區域。此矩形預設為 (或預設) MCI_PUT命令的 MCI_DGV_PUT_VIDEO旗標。當它設定與視訊矩形不同時，所顯示的不是錄製的內容

對於數位視訊裝置， lpRecord 會指向 MCI_DGV_RECORD_PARMS 結構。

下列額外的旗標會搭配 vcr 裝置類型使用：

MCI_VCR_RECORD_AT: lpRecord所識別結構的dwAt成員包含整個命令開始的時間，或當裝置到達 cue 命令所指定位置時的提示時。
MCI_VCR_RECORD_INITIALIZE: 盡可能搜尋裝置到媒體的開頭、開始錄製空白視訊和音訊，以及錄製時間碼。

對於 VCR 裝置， lpRecord 會指向 MCI_VCR_RECORD_PARMS 結構。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Mmsystem.h (包含 Windows.h)