IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator メソッド (mfidl.h)

ビデオ キャプチャ シナリオに関連するパラメーターを使用して、サンプル アロケーターを初期化します。

構文

HRESULT InitializeCaptureSampleAllocator(
  DWORD         cbSampleSize,
  DWORD         cbCaptureMetadataSize,
  DWORD         cbAlignment,
  DWORD         cMinimumSamples,
  IMFAttributes *pAttributes,
  IMFMediaType  *pMediaType
);

パラメーター

cbSampleSize

サンプル サイズをバイト単位で指定する DWORD。 アロケーターで使用される実際のサンプル サイズは、pMediaType と cbSampleSize に必要なサイズの最大値です。

cbCaptureMetadataSize

キャプチャ メタデータ サイズをバイト単位で指定する DWORD。 キャプチャされたフレームに追加のメタデータを含める呼び出し元にのみ適用されます。 メタデータ サイズには、メタデータ ペイロード自体のサイズに加えて 、KSCAMERA_METADATA_ITEMHEADER のサイズを含める必要があります。

cbAlignment

バッファー配置サイズをバイト単位で指定する DWORD。 既定と最小のアラインメント サイズは 4 KB です。 4 KB 未満のカスタム配置サイズは 4 KB として扱われます。

cMinimumSamples

事前に割り当てられたサンプルの最小数を指定する DWORD。 アロケーターが指定した最小サンプル数を事前に割り当てることができない場合、このメソッドは失敗します。

pAttributes

省略可能。 IMFAttributes には、サンプル アロケーターの追加の構成属性が格納されます。 サポートされている属性は次のとおりです。

• MF_SA_BUFFERS_PER_SAMPLE
• MF_SA_D3D11_BINDFLAGS
• MF_SA_D3D11_USAGE
• MF_SA_D3D11_SHARED
• MF_SA_D3D11_SHARED_WITHOUT_MUTEX

pMediaType

サンプルをアロケーターにするメディアの種類を指定する IMFMediaType 。 サンプル アロケーターは、このパラメーターを使用して、メディア サンプルに必要な最小サイズを計算します。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDMEDIATYPE	メディアの種類が無効です。

要件

要件	値
サポートされている最小のクライアント	Windows 10バージョン 2004 (10.0;ビルド 19041)
サポートされている最小のサーバー	Windows Server バージョン 2004 (10.0;ビルド 19041)
Header	mfidl.h