StretchDIB 函式 (vfw.h)

StretchDIB函式會將裝置獨立點陣圖從一個記憶體位置複製到另一個位置，並調整影像大小以符合目的地矩形的大小。

語法

void StretchDIB(
  LPBITMAPINFOHEADER biDst,
  LPVOID             lpDst,
  int                DstX,
  int                DstY,
  int                DstXE,
  int                DstYE,
  LPBITMAPINFOHEADER biSrc,
  LPVOID             lpSrc,
  int                SrcX,
  int                SrcY,
  int                SrcXE,
  int                SrcYE
);

參數

biDst

描述目的地位 圖的 BITMAPINFOHEADER 結構的指標。

lpDst

將接收所複製圖元位的記憶體緩衝區指標。

DstX

目的矩形原點的 X 座標。

DstY

目的地矩形原點的 Y 座標。

DstXE

目的地矩形的寬度，以圖元為單位。

DstYE

目的地矩形的高度，以圖元為單位。

biSrc

描述來源點陣圖的 BITMAPINFOHEADER 結構的指標。

lpSrc

源點陣圖資料的指標。

SrcX

來源矩形原點的 X 座標。

SrcY

來源矩形原點的 Y 座標。

SrcXE

來源矩形的寬度，以圖元為單位。

SrcYE

來源矩形的高度，以圖元為單位。

傳回值

無

備註

目的地緩衝區的大小必須夠大，才能容納每個圖元資料列結尾的任何對齊位元組。

如果 biSrc 和 biDst 對 biBitCount 有不同的值，或 biSrc的值，則此函式不會執行任何動作。 biBitCount 不等於 8、16 或 24。

此函式不會執行任何複寫或其他平滑處理。 圖元值只會以逐行、逐欄為基礎卸載或重複。

除了計算每個圖元的位數之外，此函式不會根據圖元編碼進行任何特殊處理。 特別是當圖元以超過 1 圖元的群組編碼圖元時，此函式不會產生正確的結果，如同您和 V 的 YUV 格式已減去，因此不會在每個圖元中平均表示。

在包含 Vfw.h 之前，您必須將下列這一行新增至程式碼：

#define DRAWDIB_INCLUDE_STRETCHDIB

規格需求

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