IMFMediaType::GetRepresentation メソッド (mfobjects.h)

メディアの種類の代替表現を取得します。現在、DirectShow AM_MEDIA_TYPE 構造体のみがサポートされています。

構文

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

[in] guidRepresentation

取得する表現を指定する GUID。次の値が定義されています。

値	意味
AM_MEDIA_TYPE_REPRESENTATION	メディアの種類を DirectShow AM_MEDIA_TYPE構造体に変換します。メソッドは、最も適切な形式構造 (pbFormat) を選択します。
FORMAT_MFVideoFormat	メディアの種類を、MFVIDEOFORMAT 形式の構造体を使用して DirectShow AM_MEDIA_TYPE 構造体に変換します。
FORMAT_VideoInfo	VIDEOINFOHEADER 形式の構造体を使用して、メディアの種類を DirectShow AM_MEDIA_TYPE構造体に変換します。
FORMAT_VideoInfo2	メディアの種類を、VIDEOINFOHEADER2形式の構造体を持つ DirectShow AM_MEDIA_TYPE 構造体に変換します。

[out] ppvRepresentation

表現を含む構造体へのポインターを受け取ります。メソッドは、構造体のメモリを割り当てます。呼び出し元は、 IMFMediaType::FreeRepresentation を呼び出してメモリを解放する必要があります。

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

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_ATTRIBUTENOTFOUND	メディアの種類の詳細が、要求された表現と一致しません。
MF_E_INVALIDMEDIATYPE	メディアの種類が無効です。
MF_E_UNSUPPORTED_REPRESENTATION	メディアの種類は、要求された表現をサポートしていません。

VIDEOINFOHEADER など、guidRepresentation パラメーターで特定の形式構造を要求すると、書式情報の一部が失われる可能性があります。

また、MFInitAMMediaTypeFromMFMediaType 関数を使用して、Media Foundation メディアタイプを DirectShow メディアタイプに変換することもできます。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

Service Pack 2 (SP2) 以降の Windows XP。
Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

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