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 |
|---|---|
|
Correcto. |
|
Éxito parcial; el audio no se ha representado. |
|
Éxito; Filter Graph Manager modificó un nombre de filtro para evitar la duplicación. |
|
Éxito parcial; algunas de las secuencias de esta película tienen un formato no compatible. |
|
Éxito parcial; el vídeo no se ha representado. |
|
La operación se anuló. |
|
Memoria insuficiente. |
|
Argumento de puntero NULL. |
|
No se pudo encontrar ninguna combinación de filtros intermedios para establecer la conexión. |
|
No se pudo encontrar ninguna combinación de filtros para representar la secuencia. |
|
No hay ningún tipo de medio común entre estas patillas. |
|
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 |