Méthode IMFPMediaPlayer ::SetVideoSourceRect (mfplay.h)

  • Article
Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Définit le rectangle source vidéo.

MFPlay clipse la vidéo dans ce rectangle et étire le rectangle pour remplir la fenêtre vidéo.

Syntaxe

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

Paramètres

[in] pnrcSource

Pointeur vers une structure MFVideoNormalizedRect qui spécifie le rectangle source. Ce rectangle définit la partie de la vidéo qui s’affiche. Il est spécifié dans les coordonnées normalisées, qui sont définies comme suit :

  • Le coin supérieur gauche de l’image vidéo est (0, 0).
  • Le coin inférieur droit de l’image vidéo est (1, 1).
Pour afficher l’image entière, définissez le rectangle source sur {0, 0, 1, 1}. Il s’agit de la valeur par défaut.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_INVALIDREQUEST
 L’élément multimédia actuel ne contient pas de vidéo.
MF_E_SHUTDOWN
 La méthode Shutdown de l’objet a été appelée.

Remarques

MFPlay étire le rectangle source pour remplir toute la fenêtre vidéo. Par défaut, MFPlay maintient le rapport d’aspect correct de la source, la boîte aux lettres si nécessaire. La couleur de la boîte aux lettres est contrôlée par la méthode IMFPMediaPlayer ::SetBorderColor .

Cette méthode échoue si aucun élément multimédia n’est actuellement défini ou si l’élément multimédia actuel ne contient pas de vidéo.

Pour définir la position de la vidéo avant le début de la lecture, appelez cette méthode à l’intérieur de votre gestionnaire d’événements pour l’événement MFP_EVENT_TYPE_MEDIAITEM_SET . Pour plus d’informations, consultez IMFPMediaPlayerCallback ::OnMediaPlayerEvent.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaPlayer

Utilisation de MFPlay pour la lecture audio/vidéo