CAPSTATUS 構造体 (vfw.h)

  • [アーティクル]

CAPSTATUS 構造体は、キャプチャ ウィンドウの現在の状態を定義します。

構文

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

メンバー

uiImageWidth

画像の幅 (ピクセル単位)。

uiImageHeight

画像の高さ (ピクセル単位)

fLiveWindow

ライブ ウィンドウ フラグ。 ウィンドウがプレビュー メソッドを使用してビデオを表示している場合、このメンバーの値は TRUE です 。

fOverlayWindow

オーバーレイ ウィンドウ フラグ。 ウィンドウにハードウェア オーバーレイを使用してビデオが表示されている場合、このメンバーの値は TRUE です 。

fScale

入力スケーリング フラグ。 プレビューを使用してビデオを表示するときに、ウィンドウが入力ビデオをクライアント領域にスケーリングしている場合、このメンバーの値は TRUE です。 オーバーレイを使用してビデオを表示する場合、このパラメーターは無効です。

ptScroll

ウィンドウのクライアント領域の左上隅に表示されるピクセルの x オフセットと y オフセット。

fUsingDefaultPalette

既定のパレット フラグ。 キャプチャ ドライバーが既定のパレットを使用している場合、このメンバーの値は TRUE です。

fAudioHardware

オーディオ ハードウェア フラグ。 システムに波形オーディオ ハードウェアがインストールされている場合、このメンバーの値は TRUE です 。

fCapFileExists

ファイル フラグをキャプチャします。 有効なキャプチャ ファイルが生成された場合、このメンバーの値は TRUE です。

dwCurrentVideoFrame

現在 (または最新の) ストリーミング キャプチャ中に処理されたフレームの数。 この数には、ドロップされたフレームが含まれます。

dwCurrentVideoFramesDropped

現在 (または最新の) ストリーミング キャプチャ中に削除されたフレームの数。 ドロップされたフレームは、キャプチャ レートがフレームをファイルに保存できるレートを超えたときに発生します。 この場合、キャプチャ ドライバーには、データを格納するために使用できるバッファーがありません。 ドロップされたフレームの代わりに前のフレームが表示されるため、フレームのドロップは同期に影響しません。

dwCurrentWaveSamples

現在 (または最新の) ストリーミング キャプチャ中に処理された波形オーディオ サンプルの数。

dwCurrentTimeElapsedMS

現在の (または最新の) ストリーミング キャプチャが開始されてからの時間 (ミリ秒単位)。

hPalCurrent

現在のパレットへのハンドル。

fCapturingNow

キャプチャ フラグ。 キャプチャが進行中の場合、このメンバーの値は TRUE です 。

dwReturn

エラーの戻り値。 アプリケーションでエラー コールバック関数がサポートされていない場合は、このメンバーを使用します。

wNumVideoAllocated

割り当てられたビデオ バッファーの数。 この値は、CAPTUREPARMS 構造体の wNumVideoRequested メンバーで指定された数より小さい場合があります。

wNumAudioAllocated

割り当てられたオーディオ バッファーの数。 この値は、CAPTUREPARMS 構造体の wNumAudioRequested メンバーで指定された数値より小さい場合があります。

注釈

キャプチャ ウィンドウの状態はさまざまなメッセージに応じて変化するため、アプリケーションでは、メニュー項目を有効にしたり、キャプチャ ウィンドウの実際の状態を判断したり、ビデオ形式ダイアログ ボックスを呼び出したりする必要がある場合は常に、この構造体の情報を更新する必要があります。 ストリーミング キャプチャ中にアプリケーションが生成された場合、この構造体は dwCurrentVideoFrame、dwCurrentVideoFramesDropped、dwCurrentWaveSamples、dwCurrentTimeElapsedMS メンバーのキャプチャの進行状況を返します。 この構造体の内容を更新するには、 WM_CAP_GET_STATUS メッセージまたは capGetStatus マクロを使用します。

要件

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

こちらもご覧ください

CAPTUREPARMS

ビデオ キャプチャ

ビデオ キャプチャ構造

WM_CAP_GET_STATUS