IMFDeviceTransform::GetOutputAvailableType メソッド (mftransform.h)

GetOutputAvailableType メソッドは、この Media Foundation 変換 (MFT) の出力ストリームで使用可能なメディアの種類を取得します。

構文

HRESULT GetOutputAvailableType(
  [in]  DWORD        dwOutputStreamID,
  [in]  DWORD        dwTypeIndex,
  [out] IMFMediaType **pMediaType
);

[in] dwOutputStreamID

出力ストリーム識別子。ストリーム識別子の一覧を取得するには、 IMFDeviceTransform::GetStreamIDs を呼び出します。

[in] dwTypeIndex

取得するメディアの種類のインデックス。メディアの種類は、0 からインデックスが作成され、好みのおおよその順序で返されます。

[out] pMediaType

IMFMediaType インターフェイスへのポインターを受け取ります。

このメソッドは HRESULT を返します。使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。

リターンコード	説明
S_OK	初期化に成功しました
MF_E_INVALIDREQUEST	現時点では、デバイス MFT は要求をサポートできませんでした。
MF_E_INVALIDSTREAMNUMBER	ストリーム ID が無効です。
MF_E_NO_MORE_TYPES	指定したインデックスで使用できるメディアの種類はありません。

MFT は、出力ストリームごとに使用可能なメディアの種類の一覧を定義し、優先順に並べ替えます。

このメソッドは、出力ストリームに使用できるメディアの種類を列挙します。使用可能な型を列挙するには、メソッドがMF_E_NO_MORE_TYPESを返すまで dwTypeIndex をインクリメントします。

MFT がメディアの種類を内部的に格納する場合、MFT は元の型へのポインターではなく、メディアの種類の複製を返す必要があります。それ以外の場合、呼び出し元は型を変更し、MFT の内部状態を変更する可能性があります。