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 メソッドを呼び出すと、予期しない結果になる可能性があります。

• AddInputStreams
• DeleteInputStream
• ProcessEvent
• ProcessInput
• Processmessage
• ProcessOutput
• SetInputType
• SetOutputType

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

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

要件

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

こちらもご覧ください

IMFSourceReaderEx