Método IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator (mfidl.h)

Inicializa o alocador de exemplo com parâmetros relevantes para cenários de captura de vídeo.

Sintaxe

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

Parâmetros

cbSampleSize

Um DWORD que especifica o tamanho da amostra em bytes. O tamanho real da amostra usada pelo alocador é o máximo do tamanho exigido por pMediaType e cbSampleSize.

cbCaptureMetadataSize

Um DWORD que especifica o tamanho dos metadados de captura em bytes. Aplica-se somente aos chamadores que desejam incluir metadados adicionais com os quadros capturados. O tamanho dos metadados deve incluir o tamanho de um KSCAMERA_METADATA_ITEMHEADER além do tamanho do conteúdo de metadados em si.

cbAlignment

Um DWORD que especifica o tamanho de alinhamento do buffer em bytes. O tamanho de alinhamento padrão e mínimo é 4 KB. Tamanhos de alinhamento personalizados menores que 4 KB serão tratados como 4 KB.

cMinimumSamples

Um DWORD que especifica o número mínimo de amostras pré-alocadas. Esse método falhará se o alocador não puder alocar previamente o número mínimo de amostras especificado.

pAttributes

Opcional. Um repositório IMFAttributes com atributos de configuração adicionais para o alocador de exemplo. Os atributos com suporte são:

• MF_SA_BUFFERS_PER_SAMPLE
• MF_SA_D3D11_BINDFLAGS
• MF_SA_D3D11_USAGE
• MF_SA_D3D11_SHARED
• MF_SA_D3D11_SHARED_WITHOUT_MUTEX

pMediaType

Um IMFMediaType especificando o tipo de mídia para o qual os exemplos serão alocadores. O alocador de exemplo usa esse parâmetro para calcular o tamanho mínimo necessário para os exemplos de mídia.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Requisitos