SpatialAudioObjectRenderStreamActivationParams2-Struktur (spatialaudioclient.h)

Stellt Aktivierungsparameter für einen räumlichen Audiorenderingstream dar, wobei SpatialAudioObjectRenderStreamActivationParams (spatialaudioclient.h) mit der Möglichkeit erweitert wird, Streamoptionen anzugeben. Übergeben Sie diese Struktur an ISpatialAudioClient::ActivateSpatialAudioStream , wenn Sie einen Stream aktivieren.

Syntax

typedef struct SpatialAudioObjectRenderStreamActivationParams2 {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
  SPATIAL_AUDIO_STREAM_OPTIONS          Options;
} SpatialAudioObjectRenderStreamActivationParams2;

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 von statischen räumlichen Audiokanälen angibt, die vom aktivierten Stream zugelassen werden.

MinDynamicObjectCount

Die Mindestanzahl 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, weitere Audiodaten bereitzustellen. Dieses Handle wird intern dupliziert, bevor es verwendet wird.

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.

Options

Ein Mitglied der SPATIAL_AUDIO_STREAM_OPTIONS Emumeration, wobei Optionen für den aktivierten Audiostream angegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Build 22000
Kopfzeile	spatialaudioclient.h