共用方式為

MFCalculateBitmapImageSize 函式 (mfapi.h)

  • 發行項

擷取視訊格式的影像大小。 假設 有 BITMAPINFOHEADER 結構，此函式會計算 biSizeImage 成員的正確值。

語法

HRESULT MFCalculateBitmapImageSize(
  [in]  const BITMAPINFOHEADER *pBMIH,
  [in]  UINT32                 cbBufSize,
  [out] UINT32                 *pcbImageSize,
  [out] BOOL                   *pbKnown
);

參數

[in] pBMIH

描述格式的 BITMAPINFOHEADER 結構的指標。

[in] cbBufSize

pBMIH緩衝區的大小，以位元組為單位。 大小包含位 圖INFOHEADER 結構之後的任何色彩遮罩或調色盤專案。

[out] pcbImageSize

接收影像大小，以位元組為單位。

[out] pbKnown

如果函式辨識視訊格式，則會收到 TRUE 值。 否則，會接收 FALSE值。 此參數可以是 Null。

傳回值

函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此函數已成功。
E_INVALIDARG
 BITMAPINFOHEADER結構無效，或cbBufSize的值太小。

備註

呼叫此函式之前，您必須至少設定 BITMAPINFOHEADER 結構的下列成員：

  • biCompression
  • biBitCount
  • biWidth
  • biHeight
此外，如果 biCompression是BI_BITFIELDS， BITMAPINFOHEADER 結構必須後面接著色彩遮罩的陣列。

如果 BITMAPINFOHEADER 結構描述不是視訊格式的格式，則此函式會失敗。 例如，如果 biCompresson是BI_JPEG 或 BI_PNG ，就會失敗。

如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此函式可在下列平臺上使用：

  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center 版本 2005 200325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新彙總套件) 。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfapi.h
程式庫 Mfplat.lib
Dll Mfplat.dll

另請參閱

媒體基礎函式