IMFCaptureSink::AddStream メソッド (mfcaptureengine.h)
キャプチャ ソースからこのキャプチャ シンクにストリームを接続します。
構文
HRESULT AddStream(
[in] DWORD dwSourceStreamIndex,
[in] IMFMediaType *pMediaType,
[in] IMFAttributes *pAttributes,
[out] DWORD *pdwSinkStreamIndex
);
パラメーター
[in] dwSourceStreamIndex
接続するソース ストリーム。 値には、次のいずれかを指定できます。
値 | 意味 |
---|---|
|
ストリームの 0 から始まるインデックス。 ストリームの数を取得するには、 IMFCaptureSource::GetDeviceStreamCount を呼び出します。 |
|
最初のイメージ ストリーム。 |
|
最初のビデオ ストリーム。 |
|
最初のオーディオ ストリーム。 |
[in] pMediaType
出力ストリームの目的の形式を指定する IMFMediaType ポインター。 形式の詳細は、キャプチャ シンクによって異なります。
- フォト シンク: Windows イメージング コンポーネント (WIC) と互換性のある静止画像形式。
- プレビュー シンク: 圧縮されていないオーディオまたはビデオ形式。
- レコード シンク: 出力ファイルに書き込まれるオーディオまたはビデオ形式。
[in] pAttributes
IMFAttributes インターフェイスへのポインター。 圧縮ストリームの場合は、このパラメーターを使用してエンコーダーを構成できます。 このパラメーターは NULL にすることもできます。
プレビュー シンクの場合は、このパラメーターを NULL に設定します。
[out] pdwSinkStreamIndex
キャプチャ シンクの新しいストリームのインデックスを受け取ります。 このインデックスが dwSourceStreamIndex の値と必ずしも一致するとは限らないことに注意してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
pMediaType で指定された形式は、このキャプチャ シンクでは無効です。 |
|
dwSourceStreamIndex パラメーターが無効であるか、指定したソース ストリームがこのシンクに既に接続されています。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mfcaptureengine.h |