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 |