IMFASFProfile::GetStream メソッド (wmcontainer.h)

[アーティクル]
03/04/2024

ストリームインデックスによってプロファイルからストリームを取得するか、ストリームインデックスのストリーム番号を取得します。

構文

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

パラメーター

[in] dwStreamIndex

取得するストリームのインデックス。 Streamインデックスはシーケンシャルで 0 から始まります。プロファイル内のストリームの数を取得するには、 IMFASFProfile::GetStreamCount メソッドを呼び出します。

[out] pwStreamNumber

要求されたストリームのストリーム番号を受信します。 Stream数値は 1 から始まるものであり、必ずしも連続しているわけではありません。ストリーム番号が不要な場合は、このパラメーターを NULL に設定できます。

[out] ppIStream

ASF ストリーム構成オブジェクトの IMFASFStreamConfig インターフェイスへのポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。ストリーム構成にアクセスせずにストリーム番号を取得する場合、このパラメーターは NULL にすることができます。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。

注釈

このメソッドでは、ストリーム構成オブジェクトのコピーは作成されません。取得されるポインターは、プロファイルオブジェクト内のオブジェクトを指します。このポインターを使用してストリーム構成オブジェクトを変更しないでください。これは、予期しない方法でプロファイルオブジェクトに影響を与える可能性があるためです。

プロファイル内のストリーム構成オブジェクトの構成を変更するには、まず IMFASFStreamConfig::Clone を呼び出してストリーム構成オブジェクトを複製する必要があります。オブジェクトの複製に必要な変更を加えてから、 IMFASFProfile::SetStream メソッドを呼び出して、更新されたオブジェクトを追加します。

要件

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