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的所有裝置：

下列其他旗標會搭配 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 結構。

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

對於視訊重迭裝置， lpSave 參數會指向 MCI_OVLY_SAVE_PARMS 結構。