IGetFrame：：SetFormat 方法 (vfw.h)

SetFormat方法會設定所擷取之畫面格的解壓縮影像格式，並選擇性地提供解壓縮作業的緩衝區。

語法

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

參數

lpbi

定義解壓縮影像格式的 BITMAPINFOHEADER 結構的指標。 您也可以指定 Null 或此參數的值 ((LPBITMAPINFOHEADER) 1) 。 Null 會導致解壓縮程式選擇適合編輯的格式， (通常是 24 位影像深度格式) 。 值 ((LPBITMAPINFOHEADER) 1) 會使解壓縮程式選擇適用于目前顯示模式的格式。

lpBits

緩衝區的指標，其中包含解壓縮的影像資料。 指定 Null 以讓這個方法配置緩衝區。

x

lpbi所指定之 DIB 內目的矩形的 X 座標。 當 lpBits 不是 Null時，會使用此參數。

y

lpbi所指定 DIB 內目的矩形的 Y 座標。 當 lpBits 不是 Null時，會使用此參數。

dx

目的矩形的寬度。 當 lpBits 不是 Null時，會使用此參數。

dy

目的矩形的高度。 當 lpBits 不是 Null時，會使用此參數。

傳回值

如果成功，E_OUTOFMEMORY解壓縮的影像大於緩衝區大小，否則會傳回NOERROR，否則E_FAIL。

備註

x、y、dx和dy參數會識別接收解壓縮影像之lpbi和lpBits所指定的點陣圖部分。

針對以 C++ 撰寫的處理常式， SetFormat 具有下列語法：

HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x, 
    int y, int dx, int dy); 
 

規格需求

另請參閱

自訂檔案和資料流程處理常式介面

自訂檔案和資料流程處理常式