Méthode CBaseControlWindow.GetMaxIdealImageSize

  • Article

[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 GetMaxIdealImageSize méthode récupère la taille d’image idéale maximale.

Syntaxe

HRESULT GetMaxIdealImageSize(
   long *pWidth,
   long *pHeight
);

Paramètres

pWidth

Pointeur vers la largeur idéale maximale, en pixels.

pHeight

Pointeur vers la hauteur idéale maximale, en pixels.

Valeur renvoyée

Retourne une valeur HRESULT .

Notes

Différents convertisseurs ont des restrictions de performances sur la taille des images qu’ils peuvent afficher. Bien qu’ils doivent toujours fonctionner correctement lorsqu’ils sont demandés d’afficher des images supérieures à la valeur maximale spécifiée, les convertisseurs peuvent désigner les tailles minimales et maximales idéales via l’interface IVideoWindow . Cette interface peut être appelée uniquement lorsque le graphe de filtre est suspendu ou en cours d’exécution, car ce n’est que lorsque les ressources sont allouées et que le convertisseur peut reconnaître ses restrictions. S’il n’existe aucune restriction, le convertisseur remplit les paramètres pWidth et pHeight avec les dimensions vidéo natives et retourne S_FALSE. Si des restrictions existent, la largeur et la hauteur restreintes sont entrées et la fonction membre retourne S_OK.

Les dimensions s’appliquent à la taille de la vidéo de destination et non à la taille globale de la fenêtre. Ainsi, lors du calcul de la taille de la fenêtre à définir, comptez des styles de fenêtre actuels (par exemple, WS_CAPTION et WS_BORDER).

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseControlWindow, classe