Microsoft DirectX 8.1 (C++)

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.

See Also