次の方法で共有

CAPTUREPARMS 構造体 (vfw.h)

  • [アーティクル]

CAPTUREPARMS 構造体には、ストリーミング ビデオ キャプチャ プロセスを制御するパラメーターが含まれています。 この構造体は、キャプチャ 速度、キャプチャ中に使用するバッファーの数、およびキャプチャの終了方法に影響するパラメーターを取得および設定するために使用されます。

構文

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

メンバー

dwRequestMicroSecPerFrame

要求されたフレーム レート (マイクロ秒単位)。 既定値は 66667 で、1 秒あたり 15 フレームに対応します。

fMakeUserHitOKToCapture

ユーザーによって開始されるキャプチャ フラグ。 このメンバーが TRUE の場合、AVICap はユーザーにキャプチャの開始を求めるダイアログ ボックスを表示します。 既定値は FALSE です。

wPercentDropForError

キャプチャ中にドロップされたフレームの最大許容割合。 値の範囲は 0 ～ 100 です。 既定値は 10 です。

fYield

Yield フラグ。 このメンバーが TRUE の場合、キャプチャ ウィンドウは別のバックグラウンド スレッドを生成してステップ キャプチャとストリーミング キャプチャを実行します。 既定値は FALSE です。

このフラグを設定するアプリケーションでは、キャプチャの進行中にアプリケーション内のコントロールが無効にされないため、再入の潜在的な問題を処理する必要があります。

dwIndexSize

AVI ファイル内のインデックス エントリの最大数。 値の範囲は 1800 から 324,000 です。 0 に設定すると、既定値の 34,952 (32K フレームと比例した数のオーディオ バッファー) が使用されます。

波形オーディオ データの各ビデオ フレームまたはバッファーには、1 つのインデックス エントリが使用されます。 このエントリの値は、キャプチャできるフレームまたはオーディオ バッファーの数の制限を確立します。

wChunkGranularity

AVI ファイルの論理ブロック サイズ (バイト単位)。 値 0 は、現在のセクター サイズが粒度として使用されていることを示します。

fUsingDOSMemory

Win32 アプリケーションでは使用されません。

wNumVideoRequested

割り当てるビデオ バッファーの最大数。 バッファーを配置するメモリ領域は、 fUsingDOSMemory で指定します。 メモリが使用できない場合、割り当てられるバッファーの実際の数が少なくなる可能性があります。

fCaptureAudio

オーディオ フラグをキャプチャします。 このメンバーが TRUE の場合、ストリーミング キャプチャ中にオーディオがキャプチャされます。 これは、オーディオ ハードウェアがインストールされている場合の既定値です。

wNumAudioRequested

割り当てるオーディオ バッファーの最大数。 バッファーの最大数は 10 です。

vKeyAbort

ストリーミング キャプチャを終了するために使用される仮想キーコード。 既定値はVK_ESCAPEです。 キャプチャ セッションを中止できるキーストロークを指定する前に、 RegisterHotKey 関数を呼び出す必要があります。

論理 OR 演算子と Ctrl (0x8000) と Shift (0x4000) のキーコードを使用して、Ctrl キーストロークと Shift キーストロークを含むキーコードを組み合わせることができます。

fAbortLeftMouse

マウスの左ボタンの中止フラグ。 このメンバーが TRUE の場合、マウスの左ボタンが押されるとストリーミング キャプチャが停止します。 既定値は TRUE です。

fAbortRightMouse

マウスの右ボタンの中止フラグ。 このメンバーが TRUE の場合、マウスの右ボタンが押されるとストリーミング キャプチャは停止します。 既定値は TRUE です。

fLimitEnabled

時間制限が有効なフラグ。 このメンバーが TRUE の場合、ストリーミング キャプチャは wTimeLimit の秒数が経過した後に停止します。 既定値は FALSE です。

wTimeLimit

キャプチャの時間制限 (秒単位)。 このパラメーターは、 fLimitEnabled が TRUE の場合にのみ使用されます。

fMCIControl

MCI デバイス キャプチャ フラグ。 このメンバーが TRUE の場合、AVICap はストリーミング キャプチャ中に MCI 互換のビデオ ソースを制御します。 MCI 互換のビデオ ソースには、VCR とレーザーディスクが含まれます。

fStepMCIDevice

MCI デバイス ステップ キャプチャ フラグ。 このメンバーが TRUE の場合、ビデオ ソースとして MCI デバイスを使用したステップ キャプチャが有効になります。 FALSE の場合、MCI デバイスを使用したリアルタイム キャプチャが有効になります。 ( fMCIControl が FALSE の場合、このメンバーは無視されます)。

dwMCIStartTime

キャプチャ シーケンスの MCI デバイスの開始位置 (ミリ秒単位)。 ( fMCIControl が FALSE の場合、このメンバーは無視されます)。

dwMCIStopTime

キャプチャ シーケンスの MCI デバイスの停止位置 (ミリ秒単位)。 コンテンツ内のこの位置に達すると、キャプチャが終了し、MCI デバイスが停止します。 ( fMCIControl が FALSE の場合、このメンバーは無視されます)。

fStepCaptureAt2x

二重解決ステップ キャプチャ フラグ。 このメンバーが TRUE の場合、キャプチャ ハードウェアは、指定した解像度の 2 倍でキャプチャします。 (高さと幅の解像度が 2 倍になります。

ハードウェアがハードウェアベースのデシメーションをサポートせず、RGB 形式でキャプチャする場合は、このオプションを有効にします。

wStepCaptureAverageFrames

平均サンプルに基づいてフレームを作成するときにフレームがサンプリングされる回数。 平均の数の一般的な値は 5 です。

dwAudioBufferSize

オーディオ バッファー のサイズ。 既定値の 0 を使用する場合、各バッファーのサイズは、最大 0.5 秒のオーディオまたは 10K バイトになります。

fDisableWriteCache

Win32 アプリケーションでは使用されません。

AVStreamMaster

AVI ファイルの書き込み時にオーディオ ストリームがクロックを制御するかどうかを示します。 このメンバーが AVSTREAMMASTER_AUDIO に設定されている場合、オーディオ ストリームはマスター ストリームと見なされ、ビデオ ストリームの継続時間はオーディオの継続時間と一致するように強制されます。 このメンバーがAVSTREAMMASTER_NONEに設定されている場合、オーディオストリームとビデオストリームの継続時間が異なる場合があります。

注釈

WM_CAP_GET_SEQUENCE_SETUP メッセージまたは capCaptureGetSetup マクロを使用して、現在のキャプチャ パラメーターを取得します。 WM_CAP_SET_SEQUENCE_SETUP メッセージまたは capCaptureSetSetup マクロを使用して、キャプチャ パラメーターを設定します。

WM_CAP_GET_SEQUENCE_SETUP メッセージまたは capCaptureGetSetup マクロを使用して、現在のキャプチャ パラメーターを取得します。 WM_CAP_SET_SEQUENCE_SETUP メッセージまたは capCaptureSetSetup マクロを使用して、キャプチャ パラメーターを設定します。

要件

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

こちらもご覧ください

RegisterHotKey

ビデオ キャプチャ

ビデオ キャプチャの構造

WM_CAP_GET_SEQUENCE_SETUP

WM_CAP_SET_SEQUENCE_SETUP

capCaptureGetSetup

capCaptureSetSetup