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と同等の次の形式構造でも使用できます。