MFInitAMMediaTypeFromMFMediaType 関数 (mfapi.h)

  • [アーティクル]

Media Foundation メディアの種類から DirectShow AM_MEDIA_TYPE 構造体を初期化します。

構文

HRESULT MFInitAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE *pAMType
);

パラメーター

pMFType

変換するメディアの種類の IMFMediaType インターフェイスへのポインター。

guidFormatBlockType

形式の種類 GUID。 この値は、AM_MEDIA_TYPE構造体の formattype メンバーに対応し、割り当てる書式ブロックの種類を指定します。 値がGUID_NULLの場合、関数はメジャー型とサブタイプに基づいて、正しい書式ブロックを推測しようとします。

pAMType

AM_MEDIA_TYPE構造体へのポインター。 関数は、format ブロックにメモリを割り当てます。 呼び出し元は、pbFormat メンバーで CoTaskMemFree を呼び出して、format ブロックを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 関数が正常に実行されました。
MF_E_INVALIDMEDIATYPE
 メディアの種類が無効です。

解説

この関数は、AM_MEDIA_TYPEと同等の次の形式構造でも使用できます。

  • DMO_MEDIA_TYPE (DirectX メディア オブジェクト)
  • WM_MEDIA_TYPE (Windows Media Format SDK)

要件

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

関連項目

メディア ファンデーション機能