IGraphBuilder::Render
Microsoft DirectShow 9.0 |
IGraphBuilder::Render
The Render method builds a filter graph that renders the data from a specified output pin.
Syntax
HRESULT Render( IPin *ppinOut );
Parameters
ppinOut
[in] Pointer to the IPin interface on an output pin.
Return Values
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
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also