Compartilhar via


Método ISpatialAudioMetadataItemsBuffer::AttachToPopulatedBuffer (spatialaudiometadata.h)

Anexa um buffer preenchido anteriormente para armazenamento de objetos ISpatialAudioMetadataItems . Os itens de metadados que já estão no buffer são retidos.

Sintaxe

HRESULT AttachToPopulatedBuffer(
  [in] BYTE   *buffer,
       UINT32 bufferLength
);

Parâmetros

[in] buffer

Um ponteiro para a memória a ser usado para armazenamento.

bufferLength

O comprimento do buffer fornecido. Esse tamanho deve corresponder ao comprimento necessário para o formato de metadados e a contagem máxima de itens de metadados.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
O ISpatialAudioMetadataItems não foi aberto para cópia com uma chamada para Open ou o objeto foi fechado para gravação com uma chamada para Fechar.
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED
O buffer fornecido já foi anexado.
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER
O ISpatialAudioMetadataItems foi criado para usar um buffer interno do pipeline de mídia, para que um buffer externo não possa ser anexado.
SPTLAUD_MD_CLNT_E_FORMAT_MISMATCH
O buffer preenchido fornecido usa um formato diferente do formato atual.
E_INVALIDARG
Um dos ponteiros fornecidos não é válido.

O buffer fornecido não é grande o suficiente para conter o número máximo de itens de metadados. Chame GetSpatialAudioMetadataItemsBufferLength para determinar o tamanho do buffer necessário.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho spatialaudiometadata.h

Confira também

ISpatialAudioMetadataItemsBuffer