MCI_SAVE命令

MCI_SAVE 命令會儲存目前的檔案。 修改檔案的裝置在收到儲存訊息之前,不應終結原始複本。 視訊重迭和電壓音訊裝置可辨識此命令。 雖然數位視訊裝置和 MIDI 排序器也辨識此命令,但 MCIAVI 和 MCISEQ 驅動程式不會實作它。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

參數

wDeviceID

要接收命令訊息之 MCI 裝置的裝置識別碼。

dwFlags

MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。 如需這些旗標的相關資訊,請參閱 等候、通知和測試旗標

lpSave

MCI_SAVE_PARMS結構的指標。 (具有其他參數的裝置可能會以裝置特定的結構取代此結構。)

傳回值

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

備註

當您使用 MCI_GETDEVCAPS_CAN_SAVE 旗標呼叫MCI_GETDEVCAPS命令時,傳回TRUE的裝置支援此命令。

下列額外旗標適用于支援 MCI_SAVE的所有裝置:

MCI_SAVE_FILE

lpSave所識別結構的lpfilename成員包含包含目的地檔案名的緩衝區位址。

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

MCI_DGV_RECT

lpSave所識別結構的rc成員包含有效的矩形。 矩形會指定將儲存至指定檔案的框架緩衝區區域。 第一對座標會指定矩形的左上角;第二組會指定寬度和高度。 數位視訊裝置必須使用 MCI_CAPTURE 命令來擷取畫面緩衝區的內容。 (視訊重迭裝置也應該使用 MCI_CAPTURE.) 此旗標與現有的 MCI 視訊重迭命令集相容。

MCI_DGV_SAVE_ABORT

停止進行中的儲存作業。 這必須是唯一存在的旗標。

MCI_DGV_SAVE_KEEPRESERVE

原始 MCI_RESERVE 命令剩餘未使用的磁碟空間不會解除配置。

對於數位視訊裝置, lpSave 參數會指向 MCI_DGV_SAVE_PARMS 結構。

下列額外旗標會與 重迭 裝置類型搭配使用:

MCI_OVLY_RECT

lpSave所識別結構的rc成員包含有效的顯示矩形,指出要儲存的視訊緩衝區區域。

若為視訊重迭裝置, lpSave 參數會指向 MCI_OVLY_SAVE_PARMS 結構。

規格需求

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

另請參閱

MCI

MCI 命令