IMFMediaEngine::TransferVideoFrame-Methode (mfmediaengine.h)

  • Artikel

Kopiert den aktuellen Videoframe auf eine DXGI-Oberfläche oder eine WIC-Bitmap.

Syntax

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parameter

[in] pDstSurf

Ein Zeiger auf die IUnknown-Schnittstelle der Zieloberfläche.

[in] pSrc

Ein Zeiger auf eine MFVideoNormalizedRect-Struktur , die das Quellrechteck angibt.

[in] pDst

Ein Zeiger auf eine RECT-Struktur , die das Zielrechteck angibt.

[in] pBorderClr

Ein Zeiger auf eine MFARGB-Struktur , die die Rahmenfarbe angibt.

Rückgabewert

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

Hinweise

Rufen Sie im Frame-Server-Modus diese Methode auf, um den Videoframe auf eine DXGI- oder WIC-Oberfläche zu durchschneiden. Die Anwendung kann diese Methode jederzeit aufrufen, nachdem die Medien-Engine eine Videoressource geladen hat. In der Regel ruft die Anwendung jedoch zuerst IMFMediaEngine::OnVideoStreamTick auf, um zu bestimmen, ob ein neuer Frame verfügbar ist. Wenn OnVideoStreamTickS_OK zurückgibt, ruft die Anwendung TransferVideoFrame auf.

Das Video wird von der Medien-Engine skaliert und an das Zielrechteck angepasst. Er füllt den Briefkastenbereich mit der Rahmenfarbe aus.

Rufen Sie für geschützte Inhalte anstelle dieser Methode die IMFMediaEngineProtectedContent::TransferVideoFrame-Methode auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mfmediaengine.h

Weitere Informationen

IMFMediaEngine