MFCopyImage-Funktion (mfapi.h)

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).

Anforderungen

Weitere Informationen

Bildstride

Media Foundation-Funktionen

Medientypen