Méthode IVideoWindow ::GetMaxIdealImageSize (control.h)

  • 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 pour l’image vidéo.

Syntaxe

HRESULT GetMaxIdealImageSize(
  [out] long *pWidth,
  [out] long *pHeight
);

Paramètres

[out] pWidth

Reçoit la largeur idéale maximale, en pixels.

[out] pHeight

Reçoit la hauteur idéale maximale, en pixels.

Valeur retournée

Les valeurs de retour possibles sont les suivantes :

Code de retour Description
E_POINTER
 Pointeur NULL .
S_FALSE
 Impossible de récupérer une taille d’image maximale.
S_OK
 Réussite.
VFW_E_WRONG_STATE
 Le filtre est arrêté.

Remarques

La taille idéale maximale peut différer de la taille vidéo native, car le matériel vidéo peut avoir des exigences d’étirement spécifiques.

Cette méthode retourne S_FALSE dans différentes circonstances :

Configuration requise

Condition requise Valeur
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

IVideoWindow, interface

IVideoWindow ::GetMinIdealImageSize