Método IDvdGraphBuilder::GetDvdInterface (strmif.h)

  • Artículo

[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 método GetDvdInterface recupera interfaces del gráfico de reproducción de DVD-Video para facilitar el desarrollo de DVD-Video reproducción.

Sintaxis

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

Parámetros

[in] riid

IID de la interfaz solicitada.

[out] ppvIF

Recibe un puntero a la interfaz . La aplicación debe liberar la interfaz.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
E_INVALIDARG
 El parámetro ppvIF no es válido. Este parámetro no debe ser NULL.
E_NOINTERFACE
 No se pudo devolver la interfaz solicitada.
VFW_E_DVD_GRAPHNOTREADY
 El gráfico aún no se ha compilado. Vea la sección Comentarios.

Comentarios

Puede usar este método para seleccionar y configurar un filtro de representador de vídeo antes de compilar el gráfico de filtros para la reproducción de DVD. Están disponibles las siguientes interfaces:

Si llama a GetDvdInterface para obtener cualquiera de estas interfaces antes de compilar el grafo de filtro, el Generador de gráficos de DVD crea el representador de vídeo adecuado. Usará este representador más adelante al compilar el grafo. Una vez seleccionado el representador de vídeo, ya no se pueden recuperar las interfaces de los otros representadores de vídeo. (El método GetDvdInterface devolverá E_NOINTERFACE).

Antes de compilar el gráfico de reproducción de DVD, si solicita interfaces que no estén en la lista anterior, el método devuelve VFW_E_DVD_GRAPHNOTREADY. Para compilar el gráfico de DVD, llame a IDvdGraphBuilder::RenderDvdVideoVolume. Después de compilar el gráfico, puede usar GetDvdInterface para recuperar algunas interfaces adicionales:

  • IDvdControl (en desuso), IDvdControl2, IDvdInfo (en desuso) e IDvdInfo2 para controlar la reproducción de DVD.
  • IVideoWindow, IBasicVideo e IBasicVideo2 para controlar la configuración de vídeo, solo en modo ventana.
  • IBasicAudio para controlar la configuración de audio.
  • IAMLine21Decoder para controlar la pantalla cerrada subtítulo.
  • IMixerPinConfig e IMixerPinConfig2 para configurar el primer pin de entrada del filtro mezclador de superposición, que entrega la secuencia de vídeo principal. (Para obtener esta interfaz para los otros pines en el mezclador de superposición, enumere las patillas del filtro y las consulte directamente). Las nuevas aplicaciones deben evitar el uso del filtro Mezclador de superposición.
Para obtener otras interfaces, llame a IDvdGraphBuilder::GetFiltergraph. Consulte la interfaz IGraphBuilder devuelta o use EnumFilters para enumerar los filtros.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [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

IDvdGraphBuilder (Interfaz)