IGraphBuilder::Render method (strmif.h)

Article
07/27/2023

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The Render method builds a filter graph that renders the data from a specified output pin.

Syntax

HRESULT Render(
  [in] IPin *ppinOut
);

Parameters

[in] ppinOut

Pointer to the IPin interface on an output pin.

Return value

Returns an HRESULT. Possible values include the following.

Return code	Description
S_OK	Success.
VFW_S_AUDIO_NOT_RENDERED	Partial success; the audio was not rendered.
VFW_S_DUPLICATE_NAME	Success; the Filter Graph Manager modified a filter name to avoid duplication.
VFW_S_PARTIAL_RENDER	Partial success; some of the streams in this movie are in an unsupported format.
VFW_S_VIDEO_NOT_RENDERED	Partial success; the video was not rendered.
E_ABORT	Operation aborted.
E_OUTOFMEMORY	Insufficient memory.
E_POINTER	NULL pointer argument.
VFW_E_CANNOT_CONNECT	No combination of intermediate filters could be found to make the connection.
VFW_E_CANNOT_RENDER	No combination of filters could be found to render the stream.
VFW_E_NO_ACCEPTABLE_TYPES	There is no common media type between these pins.
VFW_E_NOT_IN_GRAPH	The filter to which this pin belongs is not in the filter graph.

Remarks

This method renders the data from a specified output pin, adding new filters to the graph as needed. Filters are tried in the same order as for the IGraphBuilder::Connect method. For more information, see Intelligent Connect.

During the connection process, the Filter Graph Manager ignores pins on intermediate filters if the pin name begins with a tilde (~). For more information, see PIN_INFO.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	strmif.h (include Dshow.h)
Library	Strmiids.lib