ICaptureGraphBuilder2::GetFiltergraph
A version of this page is also available for
4/8/2010
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
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |
See Also
Reference
ICaptureGraphBuilder2 Interface
IGraphBuilder Interface
ICaptureGraphBuilder2::RenderStream
ICaptureGraphBuilder2::SetFiltergraph
ICaptureGraphBuilder2::SetOutputFileName