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

• Error and Success Codes
• ICaptureGraphBuilder2 Interface