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。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpSave

MCI_SAVE_PARMS構造体へのポインター。 (追加のパラメーターを持つデバイスは、この構造体をデバイス固有の構造に置き換える可能性があります)。

戻り値

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

注釈

このコマンドは、MCI_GETDEVCAPS_CAN_SAVE フラグを指定して MCI_GETDEVCAPS コマンドを呼び出すときに TRUE を返すデバイスでサポートされています。

次の追加フラグは、MCI_SAVEをサポートするすべてのデバイス に適用されます。

MCI_SAVE_FILE

lpSave によって識別される構造体の lpfilename メンバーには、宛先ファイル名を含むバッファーのアドレスが含まれています。

digitalvideo デバイスの種類では、次の追加フラグが使用されます。

MCI_DGV_RECT

lpSave で識別される構造体の rc メンバーには、有効な四角形が含まれています。 四角形は、指定したファイルに保存されるフレーム バッファーの領域を指定します。 座標の最初のペアは、四角形の左上隅を指定します。2 番目のペアは、幅と高さを指定します。 デジタル ビデオ デバイスでは、フレーム バッファーの内容をキャプチャするために 、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 構造体を指します。

要件

こちらもご覧ください

Mci

MCI コマンド