Méthode IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)
Copie l’image vidéo actuelle dans une surface DXGI ou une bitmap WIC.
Syntaxe
HRESULT TransferVideoFrame(
[in] IUnknown *pDstSurf,
[in] const MFVideoNormalizedRect *pSrc,
[in] const RECT *pDst,
[in] const MFARGB *pBorderClr
);
Paramètres
[in] pDstSurf
Pointeur vers l’interface IUnknown de la surface de destination.
[in] pSrc
Pointeur vers une structure MFVideoNormalizedRect qui spécifie le rectangle source.
[in] pDst
Pointeur vers une structure RECT qui spécifie le rectangle de destination.
[in] pBorderClr
Pointeur vers une structure MFARGB qui spécifie la couleur de bordure.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
En mode frame-server, appelez cette méthode pour éclaircir la trame vidéo sur une surface DXGI ou WIC. L’application peut appeler cette méthode à tout moment après le chargement d’une ressource vidéo par le moteur multimédia. En règle générale, toutefois, l’application appelle IMFMediaEngine::OnVideoStreamTick en premier pour déterminer si une nouvelle trame est disponible. Si OnVideoStreamTick retourne S_OK, l’application appelle TransferVideoFrame.
Le moteur multimédia met à l’échelle et met à l’échelle la vidéo pour qu’elle s’adapte au rectangle de destination. Il remplit la zone de boîte aux lettres avec la couleur de bordure.
Pour le contenu protégé, appelez la méthode IMFMediaEngineProtectedContent::TransferVideoFrame au lieu de cette méthode.
Spécifications
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mfmediaengine.h |