IAMStreamControl

IAMStreamControl インターフェイスは、フィルター上の個々のストリームを制御します。

StartAt メソッドは、データの配信をいつ開始するかをピンに通知します。

メソッドが成功した場合、戻り値は S_OK です。それ以外の場合は、失敗の原因を示す HRESULT 値を返します。

既定では、ピンはフィルター グラフが実行されるとすぐにデータを配信します。StartAt メソッドを使用すると、ピンはグラフの実行後、指定した時刻になるまで待機してからデータの配信を開始します。

dwCookie パラメーターが 0 以外の場合、ピンはデータの配信を開始するときに EC_STREAM_CONTROL_STARTED イベントを送信します。第 1 のイベント パラメーターはピンの IPin インターフェイスへのポインターであり、第 2 のパラメーターは dwCookie の値です。

このメソッドは、次の特殊なケースを実装します。

• ptStart が NULL の場合、ピンはグラフの実行時にすぐに開始します。イベントは送信されず、dwCookie の値は無視されます。
• ptStart に MAXLONGLONG の値が含まれ、保留中の停止要求がある場合、ピンはグラフの実行時に開始します。保留中の停止要求がない場合、ピンは停止したままになります。いずれの場合も、開始イベントは送信されず、dwCookie の値は無視されます。

• 開始時刻がサンプルの開始時刻と停止時刻の間にある場合、ピンはそのサンプルを配信します。
• 開始時刻が停止時刻と等しい場合、ピンは 1 つのサンプルを配信します。

StopAt メソッドは、データの配信をいつ停止するかをピンに通知します。

メソッドが成功した場合、戻り値は S_OK です。それ以外の場合は、失敗の原因を示す HRESULT 値を返します。

dwCookie パラメーターが 0 以外の場合、ピンはデータの配信を停止するときに EC_STREAM_CONTROL_STOPPED イベントを送信します。第 1 のイベント パラメーターはピンの IPin インターフェイスへのポインターであり、第 2 のパラメーターは dwCookie の値です。ptStop が NULL または MAXLONGLONG の場合、イベントは送信されず、dwCookie の値は無視されます。

ビデオ キャプチャでは、通常、このメソッドをキャプチャ フィルターの出力ピンとマルチプレクサーの入力ピンに対して呼び出します。アプリケーションは、マルチプレクサーからの停止イベントを待機する必要があります。これにより、キャプチャ フィルターが適切な数のフレームを送信すると同時に、すべてのフレームがマルチプレクサーに到達することが保証されます。また、bSendExtra パラメーターは、キャプチャ ピンに対しては TRUE に、マルチプレクサー ピンに対しては FALSE に設定します。これにより、キャプチャ フィルターは 1 つの追加フレームを送信します。マルチプレクサーはキャプチャ ピンからのタイム スタンプに依存するため、追加フレームが送信されないと、マルチプレクサーは停止時刻を無期限に待機します。マルチプレクサーは追加フレームを受信すると、それを破棄します。

このメソッドは、次の境界条件を処理します。

• 停止時刻がサンプルの開始時刻と停止時刻の間にある場合、ピンはそのサンプルを配信します。
• 開始時刻が停止時刻と等しい場合、ピンは 1 つのサンプルを配信します。

GetInfo メソッドは、開始時刻や停止時刻を含む、現在のストリーム制御設定に関する情報を取得します。

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