Méthode IDvdControl2 ::SetSubpictureState (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 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 |
|---|---|
|
Réussite. |
|
Le NAVIGATEUR DE DVD se trouve dans le domaine First Play. |
|
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 |
|
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 |