IMFSourceReaderEx::GetTransformForStream メソッド (mfreadwrite.h)

  • [アーティクル]

指定したストリームの Media Foundation 変換 (MFT) へのポインターを取得します。

構文

HRESULT GetTransformForStream(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwTransformIndex,
  [out] GUID         *pGuidCategory,
  [out] IMFTransform **ppTransform
);

パラメーター

[in] dwStreamIndex

MFT に対してクエリを実行するストリーム。 値には、次のいずれかを指定できます。

値 意味
0 ~ 0xFFFFFFFB
 ストリームの 0 から始まるインデックス。
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 最初のビデオ ストリーム。
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 最初のオーディオ ストリーム。

[in] dwTransformIndex

取得する MFT の 0 から始まるインデックス。

[out] pGuidCategory

MFT のカテゴリを指定する GUID を受け取ります。 使用可能な値の一覧については、「 MFT_CATEGORY」を参照してください。

[out] ppTransform

MFT の IMFTransform インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
MF_E_INVALIDINDEX
 dwTransformIndex パラメーターが範囲外です。
MF_E_INVALIDSTREAMNUMBER
 dwStreamIndex パラメーターが無効です。

注釈

MFT を処理チェーンに挿入した後で、このメソッドを使用して構成できます。 ppTransform で返されるポインターを使用して、MFT でメディアの種類を設定したり、データを処理したりしないでください。 特に、次のいずれかの IMFTransform メソッドを呼び出すと、予期しない結果になる可能性があります。

デコーダーが存在する場合は、インデックス位置 0 に表示されます。

データを失わないようにするには、このメソッドを呼び出す前にソース リーダーをドレインする必要があります。 詳細については、「 データ パイプラインのドレイン」を参照してください。

要件

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

こちらもご覧ください

IMFSourceReaderEx