Partager via

Structure SpatialAudioObjectRenderStreamActivationParams2 (spatialaudioclient.h)

  • Article

Représente les paramètres d’activation d’un flux de rendu audio spatial, en étendant SpatialAudioObjectRenderStreamActivationParams (spatialaudioclient.h) avec la possibilité de spécifier des options de flux. Transmettez cette structure à ISpatialAudioClient ::ActivateSpatialAudioStream lors de l’activation d’un flux.

Syntaxe

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;

Membres

ObjectFormat

Mettre en forme le descripteur pour un seul objet audio spatial. Tous les objets utilisés par le flux doivent avoir le même format et le format doit être de type WAVEFORMATEX ou WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Combinaison de valeurs AudioObjectType au niveau du bit indiquant l’ensemble de canaux audio spatiaux statiques autorisés par le flux activé.

MinDynamicObjectCount

Nombre minimal d’objets dynamiques simultanés. Si ce nombre d’objets audio dynamiques ne peut pas être activé simultanément, ISpatialAudioClient ::ActivateSpatialAudioStream échoue avec cette erreur SPTLAUDCLNT_E_NO_MORE_OBJECTS.

MaxDynamicObjectCount

Nombre maximal d’objets dynamiques simultanés qui peuvent être activés avec ISpatialAudioObjectRenderStream.

Category

Catégorie du flux audio et de ses objets audio spatiaux.

EventHandle

Événement qui indique au client de fournir davantage de données audio. Ce handle sera dupliqué en interne avant d’être utilisé.

NotifyObject

Objet qui fournit des notifications permettant aux clients audio spatiaux de répondre aux modifications de l’état d’un ISpatialAudioObjectRenderStream. Cet objet est utilisé pour informer les clients que le nombre d’objets audio spatiaux dynamiques qui peuvent être activés simultanément est sur le point de changer.

Options

Membre du SPATIAL_AUDIO_STREAM_OPTIONS emumeration, spécifiant les options pour le flux audio activé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Build 22000
En-tête spatialaudioclient.h