Método IDvdInfo2::GetState (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.
El GetState método recupera un marcador que contiene la ubicación del disco y la información de estado del navegador de DVD.
Sintaxis
HRESULT GetState(
[out] IDvdState **pStateData
);
Parámetros
[out] pStateData
Recibe un puntero a la interfaz IDvdState de un objeto DvdState asignado por el navegador de DVD.
Valor devuelto
Devuelve uno de los siguientes valores HRESULT .
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
Argumento no válido. |
|
El navegador de DVD no se inicializa. |
Observaciones
Cuando se llama a este método, el navegador de DVD crea un nuevo objeto de estado y guarda la ubicación actual en él, así como el nivel parental actual y otra información de estado. El objeto DVDState se puede usar para restaurar el navegador de DVD en la ubicación guardada más adelante a través de una llamada a IDvdControl2::SetState. Esto permite a los espectadores dejar de ver en medio de un disco, guardar la ubicación y volver en algún momento posterior para empezar a ver dónde se dejaron, con todas las configuraciones internas restauradas como estaban antes.
El navegador de DVD llama a AddRef en el objeto DvdState antes de devolverlo a la aplicación. La aplicación debe llamar a Release en el objeto cuando haya terminado con él.
Este método se muestra en la aplicación DVDSample en CDvdCore::RestoreBookmark.
Requisitos
| 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) |
| Library | Strmiids.lib |