IAMPushSource インターフェイス (strmif.h)

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

インターフェイスは IAMPushSource 、ライブ ソースをレンダリングするフィルター グラフを同期します。 ライブ ソースは、キャプチャ デバイスやネットワーク ブロードキャストなど、リアルタイムでデータをストリーミングするソースです。

ライブ データをストリーミングするソース フィルターでは、出力ピンでこのインターフェイスを公開する必要があります。 一般に、アプリケーションはこのインターフェイスで メソッドを呼び出すべきではありません。代わりに、 IAMGraphStreams インターフェイスを 使用します。

継承

IAMPushSource インターフェイスは IAMLatency から継承されます。 IAMPushSource には、次の種類のメンバーもあります。

メソッド

IAMPushSource インターフェイスには、次のメソッドがあります。

注釈

Filter Graph Manager は、このインターフェイスのメソッドを使用して、ライブ ソースのレンダリング時に一般的に発生する 2 つの問題に対処します。

• 待機時間: フィルター グラフに複数のライブ ソースが含まれている場合、多くの場合、ソースの待機時間が異なり、同期しなくなる可能性があります。たとえば、オーディオ キャプチャの待機時間がビデオ キャプチャよりも長い場合、グラフで差が補正されない限り、オーディオはビデオよりも遅れます。
• レート一致: レンダラー フィルターがライブ ソースに接続されている場合は、ソース フィルターの生産率に合わせてデータ消費率を調整する必要があります。 そうしないと、データにギャップがある可能性があります (レンダラーの実行速度がソースよりも速い場合)、またはデータが削除される可能性があります (ソースの実行速度が速い場合)。

レート マッチングを実行するには、フィルター グラフで、レンダラー フィルターがソース フィルターとクロック レートを一致できるかどうかを判断する必要があります。 IAMPushSource::GetPushSourceFlags メソッドは、レンダラーがソースとレートを照合しても安全かどうかを示すフラグのセットを返します。

これらの問題は、ファイルへのキャプチャには影響しません。 ファイル ライター フィルターは、受信サンプルのタイム スタンプに依存してファイルを正しく書き込みます。その後、ストリームは再生中に同期されます。 レートマッチングに関しては、データは常にできるだけ速くファイルに書き込まれます。

要件

こちらもご覧ください

IAMLatency