|Microsoft DirectX 9.0|
The GetGroupOutputPin method retrieves the output pin for the specified
HRESULT GetGroupOutputPin( long Group, IPin **ppRenderPin );
Zero-based index that specifies the group.
[out] Address of a pointer to receive the output pin's IPin interface.
Returns an HRESULT value. Possible values include the following:
|S_FALSE||Group does not have an output pin.|
|E_MUST_INIT_RENDERER||Render engine failed to initialize.|
|E_RENDER_ENGINE_IS_BROKEN||Operation failed because project was not rendered successfully.|
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.
Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.
Library: Use strmiids.lib.