Partager via

Structure SpatialAudioObjectRenderStreamForMetadataActivationParams (spatialaudiometadata.h)

  • Article

Représente les paramètres d’activation d’un flux de rendu audio spatial pour les métadonnées. Transmettez cette structure à ISpatialAudioClient ::ActivateSpatialAudioStream lors de l’activation d’un flux.

Syntaxe

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;

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é.

MetadataFormatId

Identificateur du format de métadonnées pour le moteur de rendu spatial actuellement actif.

MaxMetadataItemCount

Nombre maximal d’éléments de métadonnées par image.

MetadataActivationParams

Paramètres d’activation supplémentaires.

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.

Configuration requise

Condition requise Valeur
En-tête spatialaudiometadata.h