SpatialAudioObjectRenderStreamForMetadataActivationParams-Struktur (spatialaudiometadata.h)

  • Artikel

Stellt Aktivierungsparameter für einen räumlichen Audiorenderungsdatenstrom für Metadaten dar. Übergeben Sie diese Struktur an ISpatialAudioClient::ActivateSpatialAudioStream , wenn Sie einen Stream aktivieren.

Syntax

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;

Member

ObjectFormat

Formatdeskriptor für ein einzelnes räumliches Audioobjekt. Alle vom Stream verwendeten Objekte müssen das gleiche Format aufweisen, und das Format muss vom Typ WAVEFORMATEX oder WAVEFORMATEXTENSIBLE sein.

StaticObjectTypeMask

Eine bitweise Kombination von AudioObjectType-Werten , die den Satz statischer räumlicher Audiokanäle angibt, die vom aktivierten Stream zugelassen werden.

MinDynamicObjectCount

Die Minimale Anzahl gleichzeitiger dynamischer Objekte. Wenn diese Anzahl dynamischer Audioobjekte nicht gleichzeitig aktiviert werden kann, schlägt ISpatialAudioClient::ActivateSpatialAudioStream mit diesem Fehler SPTLAUDCLNT_E_NO_MORE_OBJECTS fehl.

MaxDynamicObjectCount

Die maximale Anzahl gleichzeitiger dynamischer Objekte, die mit ISpatialAudioObjectRenderStream aktiviert werden können.

Category

Die Kategorie des Audiostreams und seiner räumlichen Audioobjekte.

EventHandle

Das Ereignis, das dem Client signalisiert, mehr Audiodaten bereitzustellen. Dieses Handle wird intern dupliziert, bevor es verwendet wird.

MetadataFormatId

Der Bezeichner des Metadatenformats für die derzeit aktive Räumliche Rendering-Engine.

MaxMetadataItemCount

Die maximale Anzahl von Metadatenelementen pro Frame.

MetadataActivationParams

Zusätzliche Aktivierungsparameter.

NotifyObject

Das -Objekt, das Benachrichtigungen für räumliche Audioclients bereitstellt, um auf Änderungen im Zustand eines ISpatialAudioObjectRenderStream zu reagieren. Dieses Objekt wird verwendet, um Clients zu benachrichtigen, dass sich die Anzahl dynamischer räumlicher Audioobjekte, die gleichzeitig aktiviert werden können, ändern wird.

Anforderungen

Anforderung Wert
Header spatialaudiometadata.h