Interface IDvdState (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
A interface IDvdState armazena em cache o estado atual.
O objeto que implementa essa interface é chamado de indicador de DVD. Você pode usá-lo para salvar e restaurar o estado do DVD, que inclui o local de reprodução, o nível parental do usuário e a região do DVD.
Herança
A interface IDvdState herda da interface IUnknown . IDvdState também tem esses tipos de membros:
Métodos
A interface IDvdState tem esses métodos.
| IDvdState::GetDiscID O método GetDiscID recupera a ID exclusiva do disco do qual o indicador foi feito. |
| IDvdState::GetParentalLevel O método GetParentalLevel recupera o nível parental do usuário, conforme salvo no objeto DvdState. |
Comentários
Para obter as informações de estado do DVD atual do Dvd Navigator, chame IDvdInfo2::GetState. Para restaurar o estado, chame IDvdControl2::SetState.
O objeto de indicador dvd também implementa IPersistStream e IPersistMemory. Você pode usar essas interfaces para persistir o estado. Você também pode criar um objeto de indicador vazio chamando CoCreateInstance. O CLSID do objeto é CLSID_DVDState, definido em uuids.h.
Antes do Windows Vista, um indicador só pode ser usado no mesmo computador em que foi criado. A partir do Windows Vista, o Navegador de DVD é capaz de criar indicadores que podem ser usados em outros computadores. Para habilitar esse recurso, chame IDvdControl2::SetOption com o sinalizador DVD_EnablePortableBookmarks antes de chamar GetState ou SetState.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |