User manual - カメラライブラリマニュアルver.1.05(2011年2月18日)

67
4.41 CAMStopVideoCapture
動画撮影を停止します。
[C++]
int CAMStopVideoCapture(
DWORD dwReserved
)
[Visual Basic]
Public Shared Function CAMStopVideoCapture( _
ByVal dwReserved As Int32 _
) As Int32
[C#]
public static Int32 CAMStopVideoCapture(
Int32 dwReserved
);
解説
動画撮影を停止します。
本関数を実行すると、カメラからの画像取り込みを停止しますが、エンコードは継続しています。
エンコード中に、エンコードが完了した場合、保存先が容量不足になった場合、およびプログラムメモ
リ不足が発生した場合は、エンコードを自動停止します。
その際に、イベントおよびメッセージを発行します。
■ ウィンドウメッセージ通知
WM_CAM_AUTOSTOPVCAM( WM_USER + 0x568 )のウィンドウメッセージを送信します。
また、ウィンドウメッセージの wParam に完了条件を示す以下の値を格納しています。
CAM_VCAP_FILE_COMPLETED
: エンコードが完了しました
CAM_VCAP_DISKSHORTAGE
: 保存先の空き容量が残りわずかです
CAM_VCAP_MEMORYSHORTAGE
: プログラムメモリ不足が発生しました
CAM_VCAP_INTERNALERROR
: 内部エラーが発生しました
■ イベント通知
自動停止時に発行するイベントは“CAMEventAutoStopVideoCapture”です。
パラメータ
dwReserved
現在のバージョンではこの引数を使用しません。NULL を指定してください。
戻り値
以下の値を返します。
CAM_SUCCESS
: 正常終了
CAM_NOTOPENED
: カメラドライバをロードしていません
CAM_INVALID_PARAM
: 引数が正しくありません
CAM_NOT_STARTED
: プレビューが開始されていません
CAM_NOT_VCAP_START
: 動画撮影を開始していません