Método IDvdGraphBuilder::RenderDvdVideoVolume (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 RenderDvdVideoVolume método completa la creación de un gráfico de filtros según las especificaciones del usuario para reproducir un volumen de DVD-Video.

Sintaxis

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Parámetros

[in] lpcwszPathName

Puntero a la ruta de acceso del volumen de DVD-Video que se va a reproducir. Puede ser NULL.

[in] dwFlags

OR bit a bit de marcas de AM_DVD_GRAPH_FLAGS enumeración, especificando cómo crear el gráfico de reproducción de DVD.

[out] pStatus

Puntero a una estructura de AM_DVD_RENDERSTATUS . Cuando el método devuelve, la estructura indica los errores de representación.

Valor devuelto

Devuelve un valor HRESULT que depende de la implementación de la interfaz. Los valores devueltos de implementación de DirectShow incluyen lo siguiente:

Código devuelto	Descripción
E_INVALIDARG	El parámetro dwFlags especifica opciones en conflicto.
S_FALSE	El método se realizó correctamente parcialmente. Para averiguar qué errores se produjeron, examine el parámetro pStatus .
S_OK	El método se realizó correctamente y se representaron todas las secuencias.
VFW_E_DVD_DECNOTENOUGH	No se pudieron representar una o más secuencias. Si especificó la marca AM_DVD_HWDEC_ONLY o AM_DVD_SWDEC_ONLY en el parámetro dwFlags , intente volver a llamar al método con la marca AM_DVD_HWDEC_PREFER o AM_DVD_SWDEC_PREFER.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH	El gráfico de filtros ya contiene un representador de vídeo. El método devuelve este código de error si especifica la marca AM_DVD_EVR_ONLY en el parámetro dwFlags , pero el gráfico ya contiene un representador de vídeo distinto del filtro Enhanced Video Renderer (VMR).
VFW_E_DVD_RENDERFAIL	Error al compilar el gráfico. Por ejemplo, el Generador de gráficos de DVD no pudo crear un filtro necesario o no pudo representar ninguna de las secuencias.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH	El gráfico de filtros contiene más de un representador de vídeo.

Comentarios

La estructura AM_DVD_RENDERSTATUS refleja los códigos de error de este método. Entre los motivos de este método que devuelven S_FALSE se incluyen los siguientes:

• El gráfico se ha creado completamente, pero se cumple una de las siguientes condiciones.
  • La combinación de superposición no funciona: la aplicación no estableció la marca de AM_DVD_NOVPE y la secuencia de vídeo no se pudo colocar a través del mezclador de superposición. En este caso, si el vídeo se descodifica en el software, la aplicación tendrá suficiente información para informar al usuario de que el vídeo no estará visible. El vídeo descodificado por hardware solo será visible en un televisor conectado al puerto de salida NTSC del descodificador de vídeo de hardware.
  • El descodificador de vídeo no genera datos de línea 21. La aplicación puede mostrar una advertencia o un mensaje informativo que indica que el subtítulo no está disponible debido al descodificador.
  • No se especifica ninguna ruta de acceso de volumen y el navegador de DVD no encontró ningún volumen DVD-Video que se reproducirá. La aplicación puede pedir al usuario que inserte un disco DVD-Video si no hay ninguno disponible en la unidad cuando se inicia la reproducción.
• Algunas secuencias no se representaron. La aplicación puede indicar al usuario que no se pueden reproducir algunas secuencias.

Este método compila el gráfico sin tener conocimiento del archivo o volumen de DVD-Video que se va a reproducir. El generador de gráficos de DVD-Video compila el gráfico incluso si lpcwszPathName es NULL o si el filtro navegador de DVD no encuentra un volumen de DVD-Video predeterminado que reproducir.

Requisitos

Requisito	Value
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 (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdGraphBuilder (Interfaz)