IRenderEngine::GetGroupOutputPin
| Microsoft DirectShow 9.0 |
IRenderEngine::GetGroupOutputPin
The GetGroupOutputPin method retrieves the output pin for the specified group .
Syntax
HRESULT GetGroupOutputPin(
long Group,
IPin **ppRenderPin
);
Parameters
Group
Zero-based index that specifies the group.
ppRenderPin
[out] Address of a pointer to receive the output pin's IPin interface.
Return Value
Returns an HRESULT value. Possible values include the following:
| Value | Description |
| S_FALSE | Group does not have an output pin. |
| S_OK | Success. |
| E_INVALIDARG | Invalid argument. |
| E_MUST_INIT_RENDERER | Render engine failed to initialize. |
| E_POINTER | Invalid pointer. |
| 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. 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 IRenderEngine::RenderOutputPins.
If the method returns S_OK, the IPin interface that it returns has an outstanding reference count. Be sure to release the interface when you are finished using it.
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