MFCopyImage-Funktion (mfapi.h)

  • Artikel

Kopiert ein Bild oder eine Bildebene von einem Puffer in einen anderen.

Syntax

HRESULT MFCopyImage(
  [in] BYTE       *pDest,
  [in] LONG       lDestStride,
  [in] const BYTE *pSrc,
  [in] LONG       lSrcStride,
  [in] DWORD      dwWidthInBytes,
  [in] DWORD      dwLines
);

Parameter

[in] pDest

Zeiger auf den Anfang der ersten Pixelzeile im Zielpuffer.

[in] lDestStride

Stride des Zielpuffers in Bytes.

[in] pSrc

Zeiger auf den Anfang der ersten Pixelzeile im Quellbild.

[in] lSrcStride

Stride des Quellimages in Bytes.

[in] dwWidthInBytes

Breite des Bilds in Bytes.

[in] dwLines

Anzahl der zu kopierenden Pixelzeilen.

Rückgabewert

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

Hinweise

Diese Funktion kopiert eine einzelne Ebene des Bilds. Bei planaren YUV-Formaten müssen Sie die Funktion für jede Ebene einmal aufrufen. In diesem Fall müssen pDest und pSrc auf den Anfang jeder Ebene zeigen.

Diese Funktion ist optimiert, wenn die MMX-, SSE- oder SSE2-Befehlssätze auf dem Prozessor verfügbar sind. Die Funktion führt einen nicht temporalen Speicher aus (die Daten werden direkt in den Arbeitsspeicher geschrieben, ohne den Cache zu belasten).

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

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

Weitere Informationen

Bildstride

Media Foundation-Funktionen

Medientypen