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