MFGetStrideForBitmapInfoHeader-Funktion (mfapi.h)

  • Artikel

Berechnet den minimalen Oberflächenschritt für ein Videoformat.

Syntax

HRESULT MFGetStrideForBitmapInfoHeader(
  [in]  DWORD format,
  [in]  DWORD dwWidth,
  [out] LONG  *pStride
);

Parameter

[in] format

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] dwWidth

Breite des Bilds in Pixel.

[out] pStride

Empfängt die minimale Oberflächenschritt in Pixeln.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion berechnet den minimalen Schritt, der zum Speichern des Bilds im Arbeitsspeicher erforderlich ist. Verwenden Sie diese Funktion, wenn Sie Puffer im Systemspeicher zuweisen. Surfaces, die im Videospeicher zugeordnet sind, erfordern je nach Grafik Karte möglicherweise einen größeren Schritt.

Wenn Sie mit einem DirectX-Oberflächenpuffer arbeiten, verwenden Sie die IMF2DBuffer::Lock2D-Methode , um den Oberflächenschritt zu ermitteln.

Bei planaren YUV-Formaten gibt diese Funktion den Schritt für die Y-Ebene zurück. Je nach Format können die Chromaebenen einen anderen Schritt aufweisen.

Hinweis Vor Windows 7 wurde diese Funktion aus evr.dll exportiert. Ab Windows 7 wird diese Funktion aus mfplat.dll exportiert, und evr.dll exportiert eine Stubfunktion, die in mfplat.dll aufruft. Weitere Informationen finden Sie unter Bibliotheksänderungen in Windows 7.
 

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 Evr.lib
DLL Mfplat.dll

Weitere Informationen

Bildstride

Media Foundation-Funktionen