IMFMediaEngine::TransferVideoFrame-Methode (mfmediaengine.h)
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 |