Méthode IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)

  • Article

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

Voir aussi

IMFMediaEngine