IGraphBuilder::Render method

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

Syntax


HRESULT Render(
  [in] IPin *ppinOut
);

Parameters

ppinOut [in]

Pointer to the IPin interface on an output pin.

Return value

Returns an HRESULT. Possible values include the following.

Return codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
IGraphBuilder Interface

 

 

Show: