capture コマンド

  • [アーティクル]

capture コマンドは、フレーム バッファーの内容をコピーし、指定したファイルに格納します。 デジタル ビデオ デバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszCapture

次のフラグの 1 つまたは複数:

値 説明
as pathname キャプチャしたイメージの宛先パスとファイル名を指定します。 このフラグは必須です。
四角形 デバイスがトリミングしてディスクに保存するフレーム バッファー内の四角形の領域を指定します。 省略した場合、トリミングされた領域の既定値は、このデバイス インスタンスの以前の put "source" コマンドで指定された四角形または既定値になります。

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

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

解説

このコマンドは、デバイスが現在モーション ビデオを再生している場合や、リソースを大量に消費するその他の操作を実行している場合に失敗する可能性があります。 フレーム バッファーがリアルタイムで更新されている場合は、完全なイメージがキャプチャされるように、更新が一時的に一時停止します。 デバイスが更新を一時停止すると、視覚効果または可聴効果が発生する可能性があります。 ファイル形式、圧縮アルゴリズム、品質レベルが設定されていない場合は、既定値が使用されます。

必要条件

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

関連項目

Mci

MCI コマンド文字列

put