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

幀速率微調器。 每秒畫面格的幀速率是透過除以 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 指定的整數值，會定義每秒畫面格中的幀速率。 當轉譯器負責播放期間的計時畫面時，就會使用此值。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	vfw.h
程式庫	Vfw32.lib
Dll	Msvfw32.dll

另請參閱

視訊壓縮函式

影片壓縮管理員