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

解壓縮旗標。 定義下列值。

hpal

用於繪圖之調色盤的句柄。

hwnd

用於繪圖的視窗句柄。

hdc

用於繪圖的DC。

xDst

目的地矩形右上角的 X 座標。

yDst

目的地矩形右上角的 Y 座標。

dxDst

目的地矩形的寬度。

dyDst

目的地矩形的高度。

lpbi

BITMAPINFOHEADER 結構的指標，其中包含要解壓縮的輸入數據格式。

xSrc

來源矩形右上角的 X 座標。

ySrc

來源矩形右上角的 Y 座標。

dxSrc

來源矩形的寬度。

dySrc

來源矩形的高度。

dwRate

幀速率微調器。 每秒畫面格的幀速率是透過除以 dwScale 來取得。

dwScale

幀速率分母。 每秒畫面格的幀速率是透過除以 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。 此外，不會使用目的地矩形，而且其參數可以設定為零。

來源矩形相對於完整的視訊畫面。 來源矩形所指定的視訊框架部分會延展或縮小，以符合目的地矩形。

dwRate 和 dwScale 參數會指定解壓縮速率。 針對 dwRate 指定的整數值除以 dwScale 指定的整數值，會定義每秒畫面格中的幀速率。 當轉譯器負責播放期間的計時畫面時，就會使用此值。

規格需求

另請參閱

視訊壓縮函式

影片壓縮管理員