save 命令

save 命令會儲存 MCI 檔案。視訊重迭和電壓音訊裝置可辨識此命令。雖然數位視訊裝置和 MIDI 排序器也會辨識此命令，但 MCIAVI 和 MCISEQ 驅動程式不支援它。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
);

參數

lpszDeviceID

MCI 裝置的識別碼。當裝置開啟時，會指派此識別碼或別名。

lpszFilename

旗標，指定要儲存的檔案名，並選擇性地修改儲存作業的其他旗標。下表列出可辨識儲存命令的裝置類型，以及每種類型所使用的旗標。

下表列出可以在 lpszFilename 參數及其意義中指定的旗標。

值	意義
abort	停止進行中的儲存作業。如果使用，這必須是唯一存在的專案。
在矩形	指定相對於框架緩衝區原點的矩形。矩形會指定為X1 Y1 X2 Y2。座標 X1 Y1 會指定左上角，而座標 X2 Y2 指定寬度和高度。對於數位視訊裝置，擷取命令是用來擷取畫面緩衝區的內容。
filename	指定要指派給資料檔案的檔案名。如果未指定路徑，檔案將會放在磁片上，以及先前在明確或隱含保留命令上指定的目錄中。如果尚未發出保留，則預設磁片磁碟機和目錄是與應用程式工作相關聯的磁片磁碟機和目錄。如果指定路徑，裝置可能需要位於明確或隱含保留所指定的磁片磁碟機上。這個旗標是必要項目。
keepreserve	指定未使用的磁碟空間不會解除配置原始保留命令。

lpszFlags

可以是「wait」、「notify」或兩者。對於數位視訊和 VCR 裝置，也可以指定「測試」。如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

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

如果使用「new」裝置識別碼開啟裝置，則需要 檔案名 變數。

下列命令會將整個視訊緩衝區儲存至名為 VCAPFILE 的檔案。Tga。

save vboard c:\vcap\vcapfile.tga

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]