IMFCaptureSink インターフェイス (mfcaptureengine.h)

  • [アーティクル]

キャプチャ シンクを制御します。これは、キャプチャ デバイスから 1 つ以上のストリームを受信するオブジェクトです。

継承

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

メソッド

IMFCaptureSink インターフェイスには、これらのメソッドがあります。

 
IMFCaptureSink::AddStream

キャプチャ ソースからこのキャプチャ シンクにストリームを接続します。
IMFCaptureSink::GetOutputMediaType

このキャプチャ シンク上のストリームの出力形式を取得します。
IMFCaptureSink::GetService

基になるシンク ライター オブジェクトに対してインターフェイスのクエリを実行します。
IMFCaptureSink::P repare

エンコーダー、ビデオ プロセッサ、メディア シンクなど、必要なパイプライン コンポーネントを読み込んでキャプチャ シンクを準備します。
IMFCaptureSink::RemoveAllStreams

キャプチャ シンクからすべてのストリームを削除します。

注釈

キャプチャ エンジンは、次のキャプチャ シンクを作成します。

  • フォト シンク。 静止画像ファイルをエンコードします。
  • シンクのプレビュー。 ライブ オーディオまたはビデオをプレビューします。
  • シンクの記録。 圧縮されたオーディオ/ビデオ ファイルまたは圧縮オーディオ/ビデオ ストリームを作成します。
キャプチャ シンクへのポインターを取得するには、 IMFCaptureEngine::GetSink を呼び出します。 各キャプチャ シンクは、 IMFCaptureSink から派生したインターフェイスを実装します。 QueryInterface を呼び出して、派生インターフェイスへのポインターを取得します。
シンク インターフェイス
フォト シンク IMFCapturePhotoSink
シンクのプレビュー IMFCapturePreviewSink
シンクの記録 IMFCaptureRecordSink
 

アプリケーションでキャプチャ シンクを直接作成することはできません。

イメージ ストリームのネイティブ メディアの種類が JPEG に設定されている場合、フォト シンクはネイティブ ソース形式と同じ形式で構成する必要があります。 JPEG ネイティブ型はパススルーのみです。

イメージ ストリームのネイティブ型が JPEG に設定されている場合、効果を追加するには、イメージ ストリームのネイティブ型を非圧縮のビデオ メディアの種類 (NV12 や RGB32 など) に変更し、効果を追加します。

ネイティブ型がレコード ストリームの H.264 の場合、レコード シンクは同じメディア タイプで構成する必要があります。 H.264 ネイティブ型はパススルーのみであり、デコードできません。

H.264 を公開するレコード ストリームでは、他の型は公開されません。 H.264 レコード ストリームを効果と組み合わせて使用することはできません。 効果を追加するには、代わりに AddStream を使用してプレビュー ストリームを recordsink に接続します。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mfcaptureengine.h

こちらもご覧ください

メディア ファンデーション インターフェイス