CAPTUREPARMS 構造体 (vfw.h)

[アーティクル]
08/27/2023

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 マクロを使用して、キャプチャパラメーターを設定します。

要件

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