Compartilhar via


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)

Confira também

Aplicativos DE DVD