MCI_RECORD コマンド

  • [アーティクル]

MCI_RECORD コマンドは、現在の位置または指定した場所から別の指定した場所への記録を開始します。 VCR および波形オーディオ デバイスはこのコマンドを認識します。 デジタルビデオデバイスとMIDIシーケンサーもこのコマンドを認識しますが、MCIAVIおよびMCISEQドライバはそれを実装しません。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RECORD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_RECORD_PARMS) lpRecord
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオおよび VCR デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpRecord

MCI_RECORD_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

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

解説

このコマンドは、MCI_GETDEVCAPS_CAN_RECORD フラグを指定して MCI_GETDEVCAPS コマンドを呼び出すときに TRUE を返すデバイスでサポートされています。 MCIWAVE ドライバーの場合、ファイルを保存せずに閉じると、ファイルを開いた後に記録されたすべてのデータが破棄されます。

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

MCI_FROM

開始位置は、lpRecord で識別される構造体の dwFrom メンバーに含まれます。 位置の値に割り当てられた単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグで指定されます。 MCI_FROMが指定されていない場合、開始位置は既定で現在の位置になります。

MCI_RECORD_INSERT

新しく記録された情報は、既存のデータに挿入または貼り付ける必要があります。 一部のデバイスでは、これをサポートしていない場合があります。 サポートされている場合は、これが既定です。

MCI_RECORD_OVERWRITE

データは既存のデータを上書きする必要があります。 MCIWAVE。DRV デバイスは、このフラグに応答してMCIERR_UNSUPPORTED_FUNCTIONを返します。

MCI_TO

終了位置は、lpRecord で識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられた単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグで指定されます。 MCI_TOが指定されていない場合、終了場所は既定でコンテンツの末尾になります。

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

MCI_DGV_RECORD_AUDIO_STREAM

オーディオ ストリーム番号は、lpRecord で識別される構造体の dwAudioStream メンバーに含まれます。 このフラグを省略すると、オーディオ データが最初の物理ストリームに記録されます。

MCI_DGV_RECORD_HOLD

記録が停止すると、画面は最後の画像を保持し、 MCI_MONITOR コマンドが発行されるまでビデオの表示を再開しません。

MCI_DGV_RECORD_VIDEO_STREAM

lpRecord で識別される構造体の dwVideoStream メンバーには、ビデオ ストリーム番号が含 まれています。 このフラグを省略すると、ビデオ データは最初の物理ストリームに記録されます。

MCI_DGV_RECT

lpRecord で識別される構造体の rc メンバーに四角形を指定します。 四角形は、圧縮および保存されるピクセルのソースとして使用される外部入力の領域を指定します。 この四角形の既定値は、 MCI_PUT コマンドのMCI_DGV_PUT_VIDEO フラグによって指定された四角形 (または既定値) になります。 ビデオの四角形とは異なる方法で設定されている場合、表示される内容は記録されません

デジタル ビデオ デバイスの場合、lpRecord はMCI_DGV_RECORD_PARMS構造体を指します。

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

MCI_VCR_RECORD_AT

lpRecord によって識別される構造体の dwAt メンバーには、キュー コマンドによって指定された from 位置にデバイスが到達したときに、コマンド全体が開始される時刻、またはデバイスが cued の場合に含まれます。

MCI_VCR_RECORD_INITIALIZE

メディアの先頭にデバイスをシークし、空のビデオとオーディオの記録を開始し、可能であればタイムコードを記録します。

VCR デバイスの場合、lpRecord はMCI_VCR_RECORD_PARMS構造体を指します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

関連項目

Mci

MCI コマンド