共用方式為


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,指定以位元組為單位的緩衝區對齊大小。 默認和最小對齊大小為 4KB。 小於 4KB 的自定義對齊大小會被視為 4KB。

cMinimumSamples

DWORD,指定預先配置的樣本數目下限。 如果配置器無法預先配置指定的樣本數目下限,這個方法將會失敗。

pAttributes

選擇性。 IMFAttributes 存放區,其中包含範例配置器的其他組態屬性。 支援的屬性如下:

pMediaType

IMFMediaType,指定要配置樣本的媒體類型。 範例配置器會使用此參數來計算媒體樣本所需的最小大小。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK 此方法已成功。
MF_E_INVALIDMEDIATYPE 無效的媒體類型。

規格需求

需求
最低支援的用戶端 Windows 10 版本 2004 (10.0;組建 19041)
最低支援的伺服器 Windows Server 版本 2004 (10.0;組建 19041)
標頭 mfidl.h