Microsoft DirectX 8.1 (C++) |
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 messagesfor example, to move the window, or respond to mouse clicks in the window's client area.
See Also