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
S_OK	Correcto.
E_INVALIDARG	Argumento no válido.
E_UNEXPECTED	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

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (interfaz)