| Microsoft DirectX 8.1 (C++) |
The RenderEngine.GetGroupOutputPin method retrieves the output pin for the specified
Syntax
object.GetGroupOutputPin(
Group As Long,
ppRenderPin As IPin
)
Parameters
Group
Zero-based index that specifies the group.
ppRenderPin
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. |
Remarks
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