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 存放區,其中包含範例配置器的其他組態屬性。 支援的屬性如下:
- 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) |
標頭 | mfidl.h |