Struttura SpatialAudioObjectRenderStreamForMetadataActivationParams (spatialaudiometadata.h)

Rappresenta i parametri di attivazione per un flusso di rendering audio spaziale per i metadati. Passare questa struttura a ISpatialAudioClient::ActivateSpatialAudioStream quando si attiva un flusso.

Sintassi

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;

Members

ObjectFormat

Descrittore di formato per un singolo oggetto audio spaziale. Tutti gli oggetti utilizzati dal flusso devono avere lo stesso formato e il formato deve essere di tipo WAVEFORMATEX o WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Combinazione bit per bit di valori AudioObjectType che indica il set di canali audio spaziali statici che saranno consentiti dal flusso attivato.

MinDynamicObjectCount

Numero minimo di oggetti dinamici simultanei. Se questo numero di oggetti audio dinamici non può essere attivato contemporaneamente, ISpatialAudioClient::ActivateSpatialAudioStream avrà esito negativo con questo errore SPTLAUDCLNT_E_NO_MORE_OBJECTS.

MaxDynamicObjectCount

Numero massimo di oggetti dinamici simultanei che possono essere attivati con ISpatialAudioObjectRenderStream.

Category

Categoria del flusso audio e dei relativi oggetti audio spaziali.

EventHandle

Evento che segnalerà al client di fornire più dati audio. Questo handle verrà duplicato internamente prima di usarlo.

MetadataFormatId

Identificatore del formato dei metadati per il motore di rendering spaziale attualmente attivo.

MaxMetadataItemCount

Numero massimo di elementi di metadati per frame.

MetadataActivationParams

Parametri di attivazione aggiuntivi.

NotifyObject

Oggetto che fornisce notifiche per i client audio spaziali per rispondere alle modifiche nello stato di un ISpatialAudioObjectRenderStream. Questo oggetto viene usato per notificare ai client che il numero di oggetti audio spaziali dinamici che possono essere attivati simultaneamente sta per cambiare.

Requisiti

Requisito	Valore
Intestazione	spatialaudiometadata.h