Estrutura SpatialAudioObjectRenderStreamForMetadataActivationParams (spatialaudiometadata.h)

Representa parâmetros de ativação para um fluxo de renderização de áudio espacial para metadados. Passe essa estrutura para ISpatialAudioClient::ActivateSpatialAudioStream ao ativar um fluxo.

Sintaxe

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

Membros

ObjectFormat

Formatar descritor para um único objeto de áudio espacial. Todos os objetos usados pelo fluxo devem ter o mesmo formato e o formato deve ser do tipo WAVEFORMATEX ou WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Uma combinação bit a bit de valores AudioObjectType indicando o conjunto de canais de áudio espaciais estáticos que serão permitidos pelo fluxo ativado.

MinDynamicObjectCount

O número mínimo de objetos dinâmicos simultâneos. Se esse número de objetos de áudio dinâmicos não puder ser ativado simultaneamente, ISpatialAudioClient::ActivateSpatialAudioStream falhará com esse erro SPTLAUDCLNT_E_NO_MORE_OBJECTS.

MaxDynamicObjectCount

O número máximo de objetos dinâmicos simultâneos que podem ser ativados com ISpatialAudioObjectRenderStream.

Category

A categoria do fluxo de áudio e seus objetos de áudio espaciais.

EventHandle

O evento que sinalizará o cliente para fornecer mais dados de áudio. Esse identificador será duplicado internamente antes de ser usado.

MetadataFormatId

O identificador do formato de metadados para o mecanismo de renderização espacial atualmente ativo.

MaxMetadataItemCount

O número máximo de itens de metadados por quadro.

MetadataActivationParams

Parâmetros de ativação adicionais.

NotifyObject

O objeto que fornece notificações para clientes de áudio espacial responderem a alterações no estado de um ISpatialAudioObjectRenderStream. Esse objeto é usado para notificar os clientes de que o número de objetos de áudio espacial dinâmicos que podem ser ativados simultaneamente está prestes a ser alterado.

Requisitos