Interface IDvdState (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.]
L’interface IDvdState met en cache l’état actuel.
L’objet qui implémente cette interface est appelé signet DVD. Vous pouvez l’utiliser pour enregistrer et restaurer l’état du DVD, qui comprend l’emplacement de lecture, le niveau parental de l’utilisateur et la région DVD.
Héritage
L’interface IDvdState hérite de l’interface IUnknown. IDvdState a également les types de membres suivants :
Méthodes
L’interface IDvdState possède ces méthodes.
| IDvdState ::GetDiscID La méthode GetDiscID récupère l’ID unique du disque à partir duquel le signet a été créé. |
| IDvdState ::GetParentalLevel La méthode GetParentalLevel récupère le niveau parental de l’utilisateur comme enregistré dans l’objet DvdState. |
Remarques
Pour obtenir les informations actuelles sur l’état du DVD à partir du NAVIGATEUR DE DVD, appelez IDvdInfo2 ::GetState. Pour restaurer l’état, appelez IDvdControl2 ::SetState.
L’objet signet DVD implémente également IPersistStream et IPersistMemory. Vous pouvez utiliser ces interfaces pour conserver l’état. Vous pouvez également créer un objet bookmark vide en appelant CoCreateInstance. Le CLSID de l’objet est CLSID_DVDState, défini dans uuids.h.
Avant Windows Vista, un signet ne peut être utilisé que sur l’ordinateur où il a été créé. À partir de Windows Vista, le NAVIGATEUR DE DVD est en mesure de créer des signets qui peuvent être utilisés sur d’autres ordinateurs. Pour activer cette fonctionnalité, appelez IDvdControl2 ::SetOption avec l’indicateur DVD_EnablePortableBookmarks, avant d’appeler GetState ou SetState.
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) |