Interfaz IDvdState (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
La interfaz IDvdState almacena en caché el estado actual.
El objeto que implementa esta interfaz se denomina marcador de DVD. Puede usarlo para guardar y restaurar el estado de DVD, que incluye la ubicación de reproducción, el nivel parental del usuario y la región de DVD.
Herencia
La interfaz IDvdState hereda de la interfaz IUnknown . IDvdState también tiene estos tipos de miembros:
Métodos
La interfaz IDvdState tiene estos métodos.
| IDvdState::GetDiscID El método GetDiscID recupera el identificador único del disco desde el que se realizó el marcador. |
| IDvdState::GetParentalLevel El método GetParentalLevel recupera el nivel parental del usuario como se guarda en el objeto DvdState. |
Comentarios
Para obtener la información de estado del DVD actual del navegador de DVD, llame a IDvdInfo2::GetState. Para restaurar el estado, llame a IDvdControl2::SetState.
El objeto bookmark de DVD también implementa IPersistStream e IPersistMemory. Puede usar estas interfaces para conservar el estado. También puede crear un objeto de marcador vacío llamando a CoCreateInstance. El CLSID del objeto se CLSID_DVDState, definido en uuids.h.
Antes de Windows Vista, un marcador solo se puede usar en el mismo equipo donde se creó. A partir de Windows Vista, el navegador de DVD puede crear marcadores que se pueden usar en otros equipos. Para habilitar esta característica, llame a IDvdControl2::SetOption con la marca DVD_EnablePortableBookmarks, antes de llamar a GetState o SetState.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |