Поделиться через

Метод 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 КБ. Пользовательские размеры выравнивания меньше 4 КБ будут рассматриваться как 4 КБ.

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