共用方式為


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。 如需這些旗標的相關資訊,請參閱 Wait、Notify 和 Test Flags

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 命令