共用方式為


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)

另請參閱

Mci

MCI 命令