Método ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems (spatialaudiometadata.h)

Cria um objeto ISpatialAudioMetadataItems para armazenar itens de metadados de áudio espaciais.

Sintaxe

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

Parâmetros

[in] maxItemCount

O número máximo de itens de metadados que podem ser armazenados no ISpatialAudioMetadataItems retornado.

[in] frameCount

O intervalo válido de posições de deslocamento de quadro para itens de metadados armazenados no ISpatialAudioMetadataItems retornado.

[out, optional] metadataItemsBuffer

Se um ponteiro for fornecido, retornará uma interface ISpatialAudioMetadataItemsBuffer que fornece métodos para anexar memória fornecida pelo chamador para armazenamento de itens de metadados. Se esse parâmetro for NULL, o objeto alocará armazenamento interno para os itens. Essa interface não pode ser obtida por meio de QueryInterface.

[out] metadataItems

Recebe um objeto ISpatialAudioMetadataItems de instância que pode ser preenchido com itens de metadados usando um por ISpatialAudioMetadataWriter ou ISpatialAudioMetadataCopier e pode ser lido com um ISpatialAudioMetadataReader.

Valor retornado

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
E_INVALIDARG	O ponteiro fornecido no parâmetro metadataItems não é válido. O valor de maxItemCount ou frameCount é 0.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	spatialaudiometadata.h

Confira também

ISpatialAudioMetadataClient