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:

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