Share via


IBasicVideo2::GetPreferredAspectRatio, méthode (control.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La GetPreferredAspectRatio méthode récupère les proportions préférées.

Syntaxe

HRESULT GetPreferredAspectRatio(
  [out] long *plAspectX,
  [out] long *plAspectY
);

Paramètres

[out] plAspectX

Pointeur vers une valeur qui indique les proportions de l’axe X.

[out] plAspectY

Pointeur vers une valeur qui indique les proportions de l’axe y.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
S_OK
Opération réussie.
E_INVALIDARG
L’un des paramètres ou les deux ne sont pas valides.
E_NOINTERFACE
Le convertisseur n’implémente pas IBasicVideo2.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête control.h (include Dshow.h)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IBasicVideo2, interface