MFCalculateBitmapImageSize-Funktion (mfapi.h)

  • Artikel

Ruft die Bildgröße für ein Videoformat ab. Bei einer BITMAPINFOHEADER-Struktur berechnet diese Funktion den richtigen Wert des biSizeImage-Elements .

Syntax

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

Parameter

[in] pBMIH

Zeiger auf eine BITMAPINFOHEADER-Struktur , die das Format beschreibt.

[in] cbBufSize

Größe des pBMIH-Puffers in Bytes. Die Größe enthält alle Farbmasken oder Paletteneinträge, die der BITMAPINFOHEADER-Struktur folgen.

[out] pcbImageSize

Empfängt die Bildgröße in Bytes.

[out] pbKnown

Empfängt den Wert TRUE , wenn die Funktion das Videoformat erkennt. Andernfalls erhält der Wert FALSE. Dieser Parameter kann NULL sein.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt.
E_INVALIDARG
 Die BITMAPINFOHEADER-Struktur ist ungültig, oder der Wert von cbBufSize ist zu klein.

Hinweise

Bevor Sie diese Funktion aufrufen, müssen Sie mindestens die folgenden Member der BITMAPINFOHEADER-Struktur festlegen:

  • biCompression
  • biBitCount
  • biWidth
  • biHeight
Wenn biCompressionBI_BITFIELDS ist, muss auf die BITMAPINFOHEADER-Struktur ein Array von Farbmasken folgen.

Diese Funktion schlägt fehl, wenn die BITMAPINFOHEADER-Struktur ein Format beschreibt, das kein Videoformat ist. Es schlägt beispielsweise fehl, wenn biCompressonBI_JPEG oder BI_PNG ist.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen