MFCreateAlignedMemoryBuffer 関数 (mfapi.h)

  • [アーティクル]

指定したバイトアラインメントを使用してシステム メモリを割り当て、メモリを管理するメディア バッファーを作成します。

構文

HRESULT MFCreateAlignedMemoryBuffer(
  DWORD          cbMaxLength,
  DWORD          cbAligment,
  IMFMediaBuffer **ppBuffer
);

パラメーター

cbMaxLength

バッファーのサイズ (バイト単位)。

cbAligment

バッファーのメモリ配置を指定します。 次のいずれかの定数を使用します。

値 意味
MF_1_BYTE_ALIGNMENT
0x00000000
 1 バイトに揃えます。
MF_2_BYTE_ALIGNMENT
0x00000001
 2 バイトに揃えます。
MF_4_BYTE_ALIGNMENT
0x00000003
 4 バイトに揃えます。
MF_8_BYTE_ALIGNMENT
0x00000007
 8 バイトに揃えます。
MF_16_BYTE_ALIGNMENT
0x0000000F
 16 バイトに揃えます。
MF_32_BYTE_ALIGNMENT
0x0000001F
 32 バイトに揃えます。
MF_64_BYTE_ALIGNMENT
0x0000003F
 64 バイトに揃えます。
MF_128_BYTE_ALIGNMENT
0x0000007F
 128 バイトに揃えます。
MF_256_BYTE_ALIGNMENT
0x000000FF
 256 バイトに揃えます。
MF_512_BYTE_ALIGNMENT
0x000001FF
 512 バイトに揃えます。

ppBuffer

メディア バッファーの IMFMediaBuffer インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 関数が正常に実行されました。

注釈

メディア バッファー オブジェクトが破棄されると、割り当てられたメモリが解放されます。

要件

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

こちらもご覧ください

MFCreateMemoryBuffer

メディア バッファー

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