save コマンド

save コマンドは MCI ファイルを保存します。ビデオオーバーレイおよび波形オーディオデバイスは、このコマンドを認識します。デジタルビデオデバイスとMIDIシーケンサもこのコマンドを認識しますが、MCIAVIおよびMCISEQドライバはそれをサポートしていません。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

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

パラメーター

lpszDeviceID

MCI デバイスの識別子。この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszFilename

保存するファイルの名前を指定するフラグ、および必要に応じて、保存操作を変更する追加のフラグ。次の表に、 save コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

次の表に、 lpszFilename パラメーターで指定できるフラグとその意味を示します。

値	説明
を呼び出してプログラム実行を終了する際、	進行中の保存操作を停止します。使用する場合は、これが唯一の項目である必要があります。
四角形	フレームバッファーの原点を基準とした四角形を指定します。四角形は X1 Y1 X2 Y2 として指定されます。座標 X1 Y1 は左上隅を指定し、座標 X2 Y2 は幅と高さを指定します。デジタルビデオデバイスの場合は、キャプチャコマンドを使用してフレームバッファーの内容をキャプチャします。
ファイル名	データファイルに割り当てるファイル名を指定します。パスが指定されていない場合、ファイルはディスク上に配置され、明示的または暗黙的な予約コマンドで以前に指定されたディレクトリに配置されます。予約が発行されていない場合、既定のドライブとディレクトリはアプリケーションのタスクに関連付けられています。パスが指定されている場合、明示的または暗黙的な予約で指定されたディスクドライブ上にパスが必要になる場合があります。このフラグは必須です。
keepreserve	元の予約コマンドから残された未使用のディスク領域が割り当て解除されないことを指定します。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。デジタルビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。これらのフラグの詳細については、「待機、通知、およびテストフラグ」を参照してください。

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

デバイスが "新しい" デバイス識別子を使用して開かれた場合は、 filename 変数が必要です。

次のコマンドは、ビデオバッファー全体を VCAPFILE という名前のファイルに保存します。Tga。

save vboard c:\vcap\vcapfile.tga

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]