Microsoft DirectX 9.0


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


  IPin *ppinOut



[in] Pointer to the IPin interface on an output pin.

Return Value

Returns an HRESULT. Possible values include the following.

Value 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.


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.

See Also