IFilterGraph

IFilterGraph インターフェイスは、フィルターグラフを構築するためのメソッドを提供します。

AddFilter メソッドは、グラフにフィルターを追加します。

HRESULT 値を返します。取り得る値には次のものがあります。

フィルターの名前は NULL にすることができ、その場合は Filter Graph Manager が名前を生成します。名前が NULL でなく、かつ一意でない場合、このメソッドは新しい一意の名前を生成しようとして名前を変更します。これが成功すると、このメソッドは VFW_S_DUPLICATE_NAME を返します。一意の名前を生成できない場合は、VFW_E_DUPLICATE_NAME を返します。

AddFilter は、フィルターが追加されたことを通知するために、フィルターの IBaseFilter::JoinFilterGraph メソッドを呼び出します。追加したフィルターに属するピンを接続またはレンダリングするために IGraphBuilder::Connect、IFilterGraph::ConnectDirect、または IGraphBuilder::Render メソッドを使用する前に、AddFilter を呼び出す必要があります。

Filter Graph Manager は、フィルターがグラフから削除されるか Filter Graph Manager が解放されるまで、フィルターへの参照カウントを保持します。

RemoveFilter メソッドは、グラフからフィルターを削除します。

次のいずれかの値を返します。

Filter Graph Manager は、フィルターの IBaseFilter::JoinFilterGraph メソッドを NULL 引数で呼び出すことにより、フィルターが削除されることを通知します。RemoveFilter を呼び出す前にフィルターのピンを切断する必要はありませんが、フィルターグラフは停止状態にしておく必要があります。フィルターが停止していない場合、RemoveFilter はピンの切断に失敗し、その結果グラフからのフィルターの削除に失敗することがあります。IGraphConfig::RemoveFilterEx を使用すると、アプリケーションはピンを自動的に切断せずにフィルターを削除できます。これにより、接続された複数のフィルターを新しいグラフへまとめて移動したい場合のパフォーマンスが向上します。

EnumFilters メソッドは、グラフ内のすべてのフィルターの列挙子を提供します。

次のいずれかの値を返します。

FindFilterByName メソッドは、特定の名前でフィルターグラフに追加されたフィルターを検索します。

次のいずれかの値を返します。

フィルターが見つからない場合、このメソッドは ppFilter パラメーターに NULL ポインターを返します。

返される IBaseFilter インターフェイスには未解放の参照カウントがあります。呼び出し側はインターフェイスを解放する必要があります。

ConnectDirect メソッドは、2 つのピンを(間にフィルターを介さずに)直接接続します。

次のいずれかの値、または IPin::Connect が返すエラー値を返します。

Reconnect メソッドは、ピンを切断してから同じピンに再接続します。

次のいずれかの値を返します。

このメソッドは廃止されています。代わりに IFilterGraph2::ReconnectEx メソッドを使用してください。

フィルターは、ピン接続を再ネゴシエートするためにこのメソッドを呼び出すことができます。このメソッドは別のスレッドで実行されます。このメソッドを呼び出す前に、もう一方のピンに対して IPin::QueryAccept を呼び出し、再接続の試行が成功することを確認してください。QueryAccept が S_OK を返さない限り、このメソッドを呼び出さないでください。そうしないと、再接続は非同期に実行されるため、Reconnect メソッド自体は成功しても再接続が失敗し、フィルターグラフが不整合な状態のまま残ることがあります。

Disconnect メソッドは、このピンを切断します。

次のいずれかの値を返します。

このメソッドは接続を完全には切断しません。接続を完全に切断するには、両端を切断する必要があります。

フィルターをフィルターグラフから完全に削除するには、IFilterGraph::RemoveFilter メソッドを呼び出してください。

SetDefaultSyncSource メソッドは、参照クロックを既定のクロックに設定します。

HRESULT 値を返します。取り得る値には次のものがあります。

このメソッドは、既定のアルゴリズムを使用して参照クロックを選択するよう Filter Graph Manager に指示します。使用されるアルゴリズムの詳細については、Reference Clocks を参照してください。

通常、Filter Graph Manager が自動的にクロックを選択するため、このメソッドを呼び出す必要はありません。ただし、IMediaFilter::SetSyncSource を呼び出してクロックを上書きした場合は、SetDefaultSyncSource を使用して既定のクロックに戻すことができます。

フィルターグラフが実行中または一時停止中の場合、このメソッドは失敗します。