IRenderEngine::RenderOutputPins

 
Microsoft DirectShow 9.0

IRenderEngine::RenderOutputPins

The RenderOutputPins method creates the previewing portion of the filter graph.

Syntax

  HRESULT RenderOutputPins( void ); 

Return Value

Returns an HRESULT values. The following are possible values:

Value Description
S_OK Success.
VFW_S_AUDIO_NOT_RENDERED Cannot play back the audio stream.
E_INVALIDARG Invalid argument.
E_RENDER_ENGINE_IS_BROKEN Operation failed because project was not rendered successfully.
E_UNEXPECTED Unexpected error.

Remarks

Before calling this method, call IRenderEngine::ConnectFrontEnd to build the front end of the graph. To perform an operation other than preview, do not call this method. Instead, call IRenderEngine::GetGroupOutputPin to obtain pointers to the output pins.

If there is no sound card on the user's computer, this method returns VFW_S_AUDIO_NOT_RENDERED. There will not be audio preview in this case, but video preview is unaffected.

If the pin is from a video group, this method creates a video window. The calling thread must dispatch messages—for example, to move the window, or respond to mouse clicks in the window's client area.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also