Méthode IDvdControl2 ::SelectVideoModePreference (strmif.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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 SelectVideoModePreference méthode définit l’affichage du mode vidéo spécifié (écran large, boîte aux lettres ou panoramique) pour la lecture.

Syntaxe

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Paramètres

[in] ulPreferredDisplayMode

Valeur qui spécifie le nouveau mode d’affichage pour le contenu DVD. Membre de l’énumération DVD_PREFERRED_DISPLAY_MODE .

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Argument non valide.
VFW_E_DVD_INVALIDDOMAIN	Domaine non valide.
VFW_E_DVD_OPERATION_INHIBITED	Le contrôle UOP interdit l’opération.

Remarques

Cette méthode modifie le rapport d’aspect de la fenêtre vidéo par défaut et peut également spécifier un mécanisme de conversion de rapport d’aspect par défaut.

Pour la vidéo source anamorphique 16 x 9, formée en étirant la vidéo source de 720 x 480 à un rapport d’aspect de 16 x 9.

Widescreen La vidéo source de 16 x 9 doit être placée et étendue dans la plus grande zone 16 x 9 de la fenêtre de sortie du client. Les points forts sont relatifs à l’intérieur de la zone 16 x 9. Les barres noires doivent être ajoutées en haut/en bas ou sur les côtés pour maintenir une zone de 16 x 9.

Analyse panoramique La vidéo affichée est calculée en prenant une sous-fenêtre 4 x 3 à partir de la vidéo étirée de 16 x 9 (le décalage horizontal est fourni dans le décalage de la fenêtre de la vidéo MPEG-2). La sous-fenêtre 4 x 3 est placée dans la plus grande zone 4 x 3 de la fenêtre cliente de sortie. Les coordonnées de la mise en surbrillance sont relatives à la fenêtre de sortie 4 x 3 (et n’ont aucune relation avec la vidéo source 16 x 9). Les barres noires doivent être ajoutées en haut/bas ou sur les côtés pour conserver une zone 4 x 3.

Boîte aux lettres Une zone d’affichage de 4 x 3 est formée en prenant la plus grande zone 4 x 3 de la fenêtre cliente de sortie. Les barres noires doivent être ajoutées en haut/bas ou sur les côtés pour conserver une zone 4 x 3. La vidéo source 16 x 9 est placée dans le plus grand sous-window 16 x 9 à l’intérieur du sous-window 4 x 3. Les barres noires doivent être ajoutées en haut et en bas de la sous-fenêtre pour conserver une zone de 16 x 9. Les coordonnées de la mise en surbrillance sont relatives à la sous-fenêtre 4 x 3 (et n’ont aucune relation avec la vidéo source 16 x 9). Il est techniquement possible pour un disque de spécifier une mise en évidence qui se trouve en dehors de la zone 16 x 9 (mais toujours dans la fenêtre 4 x 3).

Pour la vidéo 4 x 3, la vidéo est placée dans la plus grande zone de sortie 4 x 3 de la fenêtre cliente de sortie. Les barres noires doivent être ajoutées en haut/bas ou sur les côtés pour conserver une zone 4 x 3.

Le tableau suivant indique le nom de la commande Annexe J auquel correspond ce nom de méthode et les domaines dans lesquels cette méthode est valide.

Nom de la commande Annexe J	Domaines valides
Video_Presentation_Mode_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdControl2 Interface