Microsoft DirectX 9.0

RenderEngine.GetGroupOutputPin Method

The GetGroupOutputPin method retrieves the output pin for the specified group.


    Group As Long,
    ppRenderPin As IPin



Zero-based index that specifies the group.


The IPin object that receives the output pin.

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

Value Description
E_INVALIDARG Invalid argument.
E_MUST_INIT_RENDERER Render engine failed to initialize.
E_RENDER_ENGINE_IS_BROKEN Operation failed because project was not rendered successfully.
E_UNEXPECTED Unexpected error.


Before calling this method, call ConnectFrontEnd to build the front end of the graph. Each group represents a single media stream, and the front end has a corresponding output pin.

You can use this method to create the rendering portion of a file-writing graph. Connect the output pins to multiplexer filters and file writer filters. For more information, see Rendering a Project.

For preview, you don't need to call this method. Just call ConnectFrontEnd followed by RenderOutputPins.

See Also