ICDrawBegin 関数 (vfw.h)

  • [アーティクル]

ICDrawBegin 関数はレンダラーを初期化し、描画先を描画用に準備します。

構文

DWORD VFWAPIV ICDrawBegin(
  HIC                hic,
  DWORD              dwFlags,
  HPALETTE           hpal,
  HWND               hwnd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  DWORD              dwRate,
  DWORD              dwScale
);

パラメーター

hic

使用する圧縮解除器にハンドルします。

dwFlags

圧縮解除フラグ。 次の値が定義されています。

値 意味
ICDRAW_ANIMATE アプリケーションはパレットをアニメーション化できます。
ICDRAW_CONTINUE 描画は、前のフレームの継続です。
ICDRAW_FULLSCREEN 圧縮解除されたデータを全画面表示で描画します。
ICDRAW_HDC 圧縮解除されたデータをウィンドウまたは DC に描画します。
ICDRAW_MEMORYDC DC は画面外です。
ICDRAW_QUERY 圧縮解除ツールでデータを圧縮解除できるかどうかを判断します。 ドライバーはデータを圧縮解除しません。
ICDRAW_UPDATING 現在のフレームは再生されずに更新されています。

hpal

描画に使用するパレットへのハンドル。

hwnd

描画に使用するウィンドウへのハンドル。

hdc

描画に使用される DC。

xDst

変換先の四角形の右上隅の x 座標。

yDst

移動先の四角形の右上隅の y 座標。

dxDst

コピー先の四角形の幅。

dyDst

移動先の四角形の高さ。

lpbi

圧縮解除する入力データの形式を含む BITMAPINFOHEADER 構造体へのポインター。

xSrc

ソース四角形の右上隅の x 座標。

ySrc

ソース四角形の右上隅の y 座標。

dxSrc

ソース四角形の幅。

dySrc

ソース四角形の高さ。

dwRate

フレーム レート分子。 フレーム レートを 1 秒あたりのフレーム数で取得するには、 dwRate を dwScale で除算します。

dwScale

フレーム レート分母。 フレーム レートを 1 秒あたりのフレーム数で取得するには、 dwRate を dwScale で除算します。

戻り値

レンダラーがデータを圧縮解除できる場合、またはそれ以外の場合は ICERR_UNSUPPORTED ICERR_OKを 返します。

注釈

ICDRAW_HDCフラグとICDRAW_FULLSCREEN フラグは相互に排他的です。 アプリケーションが dwFlags でICDRAW_HDC フラグを設定した場合、展開ツールは hwnd、hdc、およびターゲット四角形 (xDst、yDst、dxDst、dyDst) を定義するパラメーターを使用します。 アプリケーションでは、これらのパラメーターを変換先の四角形のサイズに設定する必要があります。 現在のウィンドウまたは DC を基準にして、変換先の四角形の値を指定します。

アプリケーションが dwFlags でICDRAW_FULLSCREEN フラグを設定した場合、hwnd パラメーターと hdc パラメーターは使用されず、NULL に設定する必要があります。 また、変換先の四角形は使用されず、そのパラメーターを 0 に設定できます。

ソースの四角形は、ビデオ フレーム全体に対して相対的です。 ソース四角形で指定されたビデオ フレームの部分は、目的の四角形に合わせて拡大または縮小されます。

dwRate パラメーターと dwScale パラメーターは、圧縮解除率を指定します。 dwRate に指定された整数値を dwScale に指定された整数値で除算すると、フレーム レートが 1 秒あたりのフレーム数で定義されます。 この値は、再生中にタイミング フレームを担当する場合にレンダラーによって使用されます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vfw.h
Library Vfw32.lib
[DLL] Msvfw32.dll

こちらもご覧ください

ビデオ圧縮関数

ビデオ圧縮マネージャー