Share via

MFCreate2DMediaBuffer 関数 (mfapi.h)

  • [アーティクル]

2D イメージ データを保持するシステム メモリ バッファー オブジェクトを作成します。

構文

HRESULT MFCreate2DMediaBuffer(
  [in]  DWORD          dwWidth,
  [in]  DWORD          dwHeight,
  [in]  DWORD          dwFourCC,
  [in]  BOOL           fBottomUp,
  [out] IMFMediaBuffer **ppBuffer
);

パラメーター

[in] dwWidth

画像の幅 (ピクセル単位)。

[in] dwHeight

画像の高さ (ピクセル単位)。

[in] dwFourCC

ビデオ形式を指定する FOURCC コードまたは D3DFORMAT 値。 ビデオ サブタイプ GUID がある場合は、サブタイプの最初の DWORD を使用できます。

[in] fBottomUp

TRUE の場合、バッファーの IMF2DBuffer::ContiguousCopyTo メソッドはバッファーをボトムアップ形式にコピーします。 ボトムアップ形式は、非圧縮 RGB イメージの GDI と互換性があります。 このパラメーターが FALSE の場合、 ContiguousCopyTo メソッドは、DirectX と互換性のあるトップダウン形式にバッファーをコピーします。

トップダウンイメージとボトムアップ画像の詳細については、「 Image Stride」を参照してください。

[out] ppBuffer

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

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
MF_E_INVALIDMEDIATYPE
 認識できないビデオ形式。

解説

返されたバッファー オブジェクトは、 IMF2DBuffer2 インターフェイスも公開します。

要件

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

関連項目

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