Compartir a través de


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)