record コマンド

record コマンドは、データの記録を開始します。 VCR および波形オーディオ デバイスは、このコマンドを認識します。 デジタルビデオデバイスとMIDIシーケンサもこのコマンドを認識しますが、MCIAVIおよびMCISEQドライバはそれを実装しません。

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

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

パラメーター

lpszDeviceID

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

lpszRecordFlags

データを記録するためのフラグ。 次の表に、 record コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
digitalvideo	位置ホールドからの四角形のオーディオ ストリーム ストリーム	ビデオ ストリーム ストリームの位置に上書きを挿入する
sequencer	位置挿入から	overwrite to position
ビデオデッキ	位置初期化からの時刻	insert overwrite to position
waveaudio	位置挿入から	overwrite to position

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

値	説明
四角形	圧縮および保存されるピクセルのソースとして使用される外部入力の四角形領域を指定します。 指定しない場合、四角形の既定値は put "video" に指定された四角形になります。 "ビデオ" 四角形とは異なる方法で設定されている場合、表示される画像は記録されるものではありません。
時刻	デバイスがこのコマンドの実行を開始するタイミングを示します。または、cued コマンドの開始時にデバイスが実行されている場合は を示します。 詳細については、 キュー コマンドを参照してください。
オーディオ ストリーム ストリーム	録音に使用するオーディオ ストリームを指定します。 このフラグが指定されておらず、ファイル形式でデフォルトが定義されていない場合、そのフラグは物理的に最初のストリームに記録されます。
from position	記録の開始位置を指定します。 "from" フラグが指定されていない場合、デバイスは現在の位置で記録を開始します。
保持	ライブ ビデオを表示する代わりに、記録が完了したときに画像を固定します。 記録が停止すると、自動 モニター "ファイル" コマンドが実行されます。 ライブ ビデオに戻すには、 モニター の "入力" コマンドを発行します。
initialize	テープ (メディア) を初期化します。これには、空のビデオとオーディオのタイムコード (可能な場合) の記録が含まれます。 テープ全体を初期化する必要がある場合、このコマンドには数時間かかることがあります。
insert	現在の位置にあるファイルに新しいデータが追加されることを指定します。
overwrite	新しいデータがファイル内のデータを置き換えることを指定します。
to position	記録の終了位置を指定します。 "to" フラグが指定されていない場合、デバイスは 停止 または 一時停止 コマンドを受け取るまで記録します。
ビデオ ストリーム ストリーム	記録に使用するビデオ ストリームを指定します。 これが指定されておらず、ファイル形式で既定値が定義されていない場合は、最初に物理的に記録されるストリームに記録されます。

lpszFlags

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

戻り値

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

解説

停止または一時停止コマンドが発行されると、記録は停止します。 MCIWAVE ドライバーの場合、ファイルを保存せずにファイルを閉じると、ファイルを開いた後に記録されたすべてのデータが破棄されます。

位置値を使用するコマンドを発行する前に、set コマンドを使用して目的の時刻形式を 設定 する必要があります。 記録するトラックは、 settimecode "record"、set "assemble record"、 setvideo "record"、および setaudio "record" コマンドによって指定されます。

例

次のコマンドは、現在の位置で記録を開始します。

record mysound

必要条件

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

こちらもご覧ください

Mci

MCI コマンド文字列

キュー

モニター

pause

put

set

setaudio

settimecode

setvideo

stop