IMFCaptureSink::AddStream メソッド (mfcaptureengine.h)

  • [アーティクル]

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

構文

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

パラメーター

[in] dwSourceStreamIndex

接続するソース ストリーム。 値には、次のいずれかを指定できます。

値 意味
0 ~ 0xFFFFFFFB
 ストリームの 0 から始まるインデックス。 ストリームの数を取得するには、 IMFCaptureSource::GetDeviceStreamCount を呼び出します。
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 最初のイメージ ストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 最初のビデオ ストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 最初のオーディオ ストリーム。

[in] pMediaType

出力ストリームの目的の形式を指定する IMFMediaType ポインター。 形式の詳細は、キャプチャ シンクによって異なります。

  • フォト シンク: Windows イメージング コンポーネント (WIC) と互換性のある静止画像形式。
  • プレビュー シンク: 圧縮されていないオーディオまたはビデオ形式。
  • レコード シンク: 出力ファイルに書き込まれるオーディオまたはビデオ形式。

[in] pAttributes

IMFAttributes インターフェイスへのポインター。 圧縮ストリームの場合は、このパラメーターを使用してエンコーダーを構成できます。 このパラメーターは NULL にすることもできます。

プレビュー シンクの場合は、このパラメーターを NULL に設定します。

[out] pdwSinkStreamIndex

キャプチャ シンクの新しいストリームのインデックスを受け取ります。 このインデックスが dwSourceStreamIndex の値と必ずしも一致するとは限らないことに注意してください。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
MF_E_INVALIDMEDIATYPE
 pMediaType で指定された形式は、このキャプチャ シンクでは無効です。
MF_E_INVALIDSTREAMNUMBER
 dwSourceStreamIndex パラメーターが無効であるか、指定したソース ストリームがこのシンクに既に接続されています。

要件

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

こちらもご覧ください

IMFCaptureSink