MÉTODO IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator (mfidl.h)

  • Artículo

Inicializa el asignador de ejemplo con parámetros relevantes para escenarios de captura de vídeo.

Sintaxis

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

Parámetros

cbSampleSize

DWORD que especifica el tamaño de muestra en bytes. El tamaño de muestra real utilizado por el asignador es el máximo del tamaño requerido por pMediaType y cbSampleSize.

cbCaptureMetadataSize

DWORD que especifica el tamaño de los metadatos de captura en bytes. Solo se aplica a los autores de llamadas que quieran incluir metadatos adicionales con los fotogramas capturados. El tamaño de los metadatos debe incluir el tamaño de un KSCAMERA_METADATA_ITEMHEADER además del tamaño de la propia carga de metadatos.

cbAlignment

DWORD que especifica el tamaño de alineación del búfer en bytes. El tamaño de alineación predeterminado y mínimo es de 4 KB. Los tamaños de alineación personalizados inferiores a 4 KB se tratarán como 4 KB.

cMinimumSamples

DWORD que especifica el número mínimo de muestras asignadas previamente. Este método producirá un error si el asignador no puede asignar previamente el número mínimo de muestras especificado.

pAttributes

Opcional. Un almacén IMFAttributes con atributos de configuración adicionales para el asignador de ejemplo. Los atributos admitidos son:

pMediaType

Un IMFMediaType que especifica el tipo de medio para el que se asignarán muestras. El asignador de ejemplo usa este parámetro para calcular el tamaño mínimo necesario para los ejemplos multimedia.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDMEDIATYPE Tipo de medio no válido.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004 (10.0; Compilación 19041)
Servidor mínimo compatible Windows Server, versión 2004 (10.0; Compilación 19041)
Encabezado mfidl.h