Método IGraphBuilder::Render (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 Render método crea un gráfico de filtro que representa los datos de un pin de salida especificado.

Sintaxis

HRESULT Render(
  [in] IPin *ppinOut
);

Parámetros

[in] ppinOut

Puntero a la interfaz IPin en un pin de salida.

Valor devuelto

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

Código devuelto	Descripción
S_OK	Correcto.
VFW_S_AUDIO_NOT_RENDERED	Éxito parcial; el audio no se ha representado.
VFW_S_DUPLICATE_NAME	Éxito; Filter Graph Manager modificó un nombre de filtro para evitar la duplicación.
VFW_S_PARTIAL_RENDER	Éxito parcial; algunas de las secuencias de esta película tienen un formato no compatible.
VFW_S_VIDEO_NOT_RENDERED	Éxito parcial; el vídeo no se ha representado.
E_ABORT	La operación se anuló.
E_OUTOFMEMORY	Memoria insuficiente.
E_POINTER	Argumento de puntero NULL.
VFW_E_CANNOT_CONNECT	No se pudo encontrar ninguna combinación de filtros intermedios para establecer la conexión.
VFW_E_CANNOT_RENDER	No se pudo encontrar ninguna combinación de filtros para representar la secuencia.
VFW_E_NO_ACCEPTABLE_TYPES	No hay ningún tipo de medio común entre estas patillas.
VFW_E_NOT_IN_GRAPH	El filtro al que pertenece este pin no está en el gráfico de filtros.

Comentarios

Este método representa los datos de un pin de salida especificado, agregando nuevos filtros al grafo según sea necesario. Los filtros se prueban en el mismo orden que para el método IGraphBuilder::Connect . Para obtener más información, consulte Intelligent Connect.

Durante el proceso de conexión, el Administrador de gráficos de filtros omite las patillas de los filtros intermedios si el nombre del pin comienza con una tilde (~). Para obtener más información, consulte PIN_INFO.

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

Códigos de error y éxito

IGraphBuilder (interfaz)