ICaptureGraphBuilder2::GetFiltergraph (Compact 2013)
3/26/2014
This 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 Value
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 |
dshow.h |
Library |
Strmiids.lib |
See Also
Reference
ICaptureGraphBuilder2 Interface
IGraphBuilder Interface
ICaptureGraphBuilder2::RenderStream
ICaptureGraphBuilder2::SetFiltergraph
ICaptureGraphBuilder2::SetOutputFileName