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