IFilterGraph3::SetSyncSourceEx メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは SetSyncSourceEx 、フィルター グラフの 2 つの参照クロック (ほとんどのフィルターで使用されるプライマリ クロックと、1 つの指定されたフィルターでのみ使用されるセカンダリ クロック) を確立します。

構文

HRESULT SetSyncSourceEx(
  [in] IReferenceClock *pClockForMostOfFilterGraph,
  [in] IReferenceClock *pClockForFilter,
  [in] IBaseFilter     *pFilter
);

パラメーター

[in] pClockForMostOfFilterGraph

メイン参照クロックの IReferenceClock インターフェイスへのポインター。 グラフ内のすべてのフィルターは、 pFilter パラメーターで指定されたフィルターを除き、このクロックを使用します。

[in] pClockForFilter

セカンダリ クロックの IReferenceClock インターフェイスへのポインター。 pFilter パラメーターで指定されたフィルターは、このクロックを使用します。

[in] pFilter

グラフ内のフィルターの IBaseFilter インターフェイスへのポインター。 このフィルターは、セカンダリ参照クロックを使用します。

戻り値

および HRESULT 値を 返します。 使用可能な値は次のとおりです。

リターン コード	説明
S_OK	正常終了しました。
VFW_E_NOT_STOPPED	フィルター グラフは停止しません。

注釈

フィルター グラフが実行中または一時停止している場合、このメソッドはVFW_E_NOT_STOPPEDを返します。

両方の参照クロックをクリアするには、3 つのパラメーターすべてを NULL に設定します。 セカンダリ クロックなしでグラフ全体に 1 つのクロックを設定するには、フィルター グラフ マネージャーで IMediaFilter::SetSyncSource メソッドを呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)
Library	Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IFilterGraph3 インターフェイス