MÉTHODE IMFPMediaPlayer ::SetAspectRatioMode (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.
 

Spécifie si les proportions de la vidéo sont conservées pendant la lecture.

Syntaxe

HRESULT SetAspectRatioMode(
  [in] DWORD dwAspectRatioMode
);

Paramètres

[in] dwAspectRatioMode

OR au niveau du bit d’un ou de plusieurs indicateurs de l’énumération MFVideoAspectRatioMode.

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

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 le mode de proportions 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