ICaptureGraphBuilder2::GetFiltergraph
| Microsoft DirectShow 9.0 |
ICaptureGraphBuilder2::GetFiltergraph
The GetFiltergraph method retrieves the filter graph that the capture graph builder is using.
Syntax
HRESULT GetFiltergraph( IGraphBuilder **ppfg );
Parameters
ppfg
[out] Address of a variable that receives an IGraphBuilder interface pointer.
Return Values
Returns one of the following HRESULT values.
| Return code | Description |
| S_OK | Success. |
| E_POINTER | NULL pointer argument. |
| E_UNEXPECTED | No filter graph. |
Remarks
Initially, the capture graph builder does not hold a pointer to a filter graph. This method returns E_UNEXPECTED until one of the following methods has been called:
- ICaptureGraphBuilder2::RenderStream** **
- ICaptureGraphBuilder2::SetFiltergraph
- ICaptureGraphBuilder2::SetOutputFileName
This method increments the reference count on the IGraphBuilder interface. Be sure to release the interface when you are done with it.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also