save コマンド

  • [アーティクル]

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

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

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

パラメーター

lpszDeviceID

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

lpszFilename

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

値 説明 説明
digitalvideo 四角形での中止 filenamekeepreserve
overlay 四角形 ファイル名
sequencer ファイル名
waveaudio ファイル名

次の表に、 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 [デスクトップ アプリのみ]

関連項目

Mci

MCI コマンド文字列

キャプチャ

予約