Structure SpatialAudioHrtfActivationParams (spatialaudiohrtf.h)

Spécifie les paramètres d’activation d’un ISpatialAudioRenderStreamForHrtf.

Syntaxe

typedef struct SpatialAudioHrtfActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
  SpatialAudioHrtfDistanceDecay         *DistanceDecay;
  SpatialAudioHrtfDirectivityUnion      *Directivity;
  SpatialAudioHrtfEnvironmentType       *Environment;
  SpatialAudioHrtfOrientation           *Orientation;
} SpatialAudioHrtfActivationParams;

Membres

ObjectFormat

Descripteur de format pour les objets audio spatiaux associés au flux. Tous les objets doivent avoir le même format et doivent être de type WAVEFORMATEX ou WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Combinaison de bits de valeurs AudioObjectType 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, aucun objet audio dynamique n’est activé.

MaxDynamicObjectCount

Nombre maximal d’objets dynamiques simultanés pouvant être activés avec ISpatialAudioRenderStreamForHrtf.

Category

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

EventHandle

Événement qui signale au client qu’il fournit 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 ISpatialAudioRenderStreamForHrtf. Cet objet est utilisé pour informer les clients que le nombre d’objets audio spatiaux dynamiques pouvant être activés simultanément est sur le point de changer.

DistanceDecay

Valeur par défaut facultative pour le modèle de désintégration utilisé pour les objets ISpatialAudioObjectForHrtf associés au flux. nullptr si elle est inutilisée.

Directivity

Valeur par défaut facultative pour le modèle de directivité audio spatiale utilisé pour les objets ISpatialAudioObjectForHrtf associés au flux. nullptr si elle est inutilisée.

Environment

Valeur par défaut facultative pour le type d’environnement simulé lorsque l’audio est traité pour les objets ISpatialAudioObjectForHrtf associés au flux. nullptr si elle est inutilisée.

Orientation

Valeur par défaut facultative pour l’orientation des objets ISpatialAudioObjectForHrtf associés au flux. nullptr si elle est inutilisée.

Configuration requise

Condition requise	Valeur
En-tête	spatialaudiohrtf.h