Méthode IDvdControl2 ::SetSubpictureState (strmif.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 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 SetSubpictureState méthode active ou désactive l’affichage de la sous-image.

Syntaxe

HRESULT SetSubpictureState(
  [in]  BOOL    bState,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Paramètres

[in] bState

Valeur booléenne qui spécifie si l’affichage de la sous-image est activé ; TRUE définit l’affichage de la sous-image sur pour la lecture suivante.

[in] dwFlags

OR au niveau du bit d’un ou de plusieurs indicateurs de l’énumération DVD_CMD_FLAGS , en spécifiant comment synchroniser la commande.

[out] ppCmd

Reçoit un pointeur vers un objet IDvdCmd qui peut être utilisé pour synchroniser des commandes DVD. L’appelant doit libérer l’interface. Ce paramètre peut être NULL. Pour plus d’informations, consultez Synchronisation des commandes DVD.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 Réussite.
VFW_E_DVD_INVALIDDOMAIN
 Le NAVIGATEUR DE DVD se trouve dans le domaine First Play.
VFW_E_DVD_OPERATION_INHIBITED
 Le contrôle UOP interdit l’opération.

Remarques

Les flux de sous-image sont généralement utilisés dans les menus pour le texte de bouton et parfois les graphiques de bouton, et dans la lecture vidéo pour les sous-titres, les crédits ou d’autres graphiques superposés. Ne confondez pas les sous-images avec les sous-titres ; ces derniers sont encodés dans le flux vidéo. En général, cette méthode est destinée au contrôle de l’affichage de sous-image sur la vidéo pendant que le filtre DVD Navigator lit la vidéo dans le domaine TITRE DU DVD.

Cette méthode correspond au deuxième paramètre de la commande Annexe J « Sub-picture_Stream_Change ».

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
Sous-picture_stream_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

SelectSubpictureStream