MFCreate2DMediaBuffer-Funktion (mfapi.h)

  • Artikel

Erstellt ein Systemspeicherpufferobjekt zum Speichern von 2D-Bilddaten.

Syntax

HRESULT MFCreate2DMediaBuffer(
  [in]  DWORD          dwWidth,
  [in]  DWORD          dwHeight,
  [in]  DWORD          dwFourCC,
  [in]  BOOL           fBottomUp,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] dwWidth

Breite des Bilds in Pixel.

[in] dwHeight

Höhe des Bilds in Pixel.

[in] dwFourCC

Ein FOURCC-Code oder D3DFORMAT Wert, der das Videoformat angibt. Wenn Sie über eine Videountertyp-GUID verfügen, können Sie das erste DWORD des Untertyps verwenden.

[in] fBottomUp

Bei TRUE kopiert die IMF2DBuffer::ContiguousCopyTo-Methode des Puffers den Puffer in ein Bottom-Up-Format. Das Bottom-Up-Format ist mit GDI für unkomprimierte RGB-Bilder kompatibel. Wenn dieser Parameter FALSE ist, kopiert die ContiguousCopyTo-Methode den Puffer in ein Top-Down-Format, das mit DirectX kompatibel ist.

Weitere Informationen zu Top-Down- und Bottom-Up-Bildern finden Sie unter Image Stride.

[out] ppBuffer

Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle .

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
MF_E_INVALIDMEDIATYPE
 Nicht erkanntes Videoformat.

Hinweise

Das zurückgegebene Pufferobjekt macht auch die IMF2DBuffer2-Schnittstelle verfügbar.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen