Compartilhar via


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

Anexa a memória fornecida pelo chamador para armazenamento de objetos ISpatialAudioMetadataItems .

Sintaxe

HRESULT AttachToBuffer(
  [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_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_BUFFER_ALREADY_ATTACHED
O buffer fornecido já foi anexado.
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.

Requisitos

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

Confira também

ISpatialAudioMetadataItemsBuffer