Méthode ISpatialAudioClient ::GetMaxDynamicObjectCount (spatialaudioclient.h)

  • Article

Obtient le nombre maximal d’objets audio dynamiques pour le client audio spatial.

Syntaxe

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

Paramètres

[out] value

Obtient le nombre maximal d’objets dynamiques pour ce client.

Valeur retournée

Si la méthode réussit, retourne S_OK.

Remarques

Un ISpatialAudioObject dynamique est un objet qui a été activé en définissant le paramètre type sur la méthode ISpatialAudioObjectRenderStream ::ActivateSpatialAudioObject sur AudioObjectType_Dynamic. Le client a une limite du nombre maximal d’objets audio spatiaux dynamiques qui peuvent être activés à la fois. Lorsque la capacité du pipeline de rendu audio change, le système ajuste dynamiquement le nombre maximal d’objets audio spatiaux dynamiques simultanés. Avant cela, le système appelle OnAvailableDynamicObjectCountChange pour informer les clients de la modification de la limite de ressources.

Appelez Release sur un objet ISpatialAudioObject lorsqu’il n’est plus utilisé pour libérer la ressource afin de créer de nouveaux objets audio spatiaux dynamiques.

Lorsque Windows Sonic n’est pas disponible (pour instance, lors de la lecture sur des haut-parleurs stéréo d’ordinateur portable incorporés, ou si l’utilisateur n’a pas explicitement activé Windows Sonic sur l’appareil), le nombre d’objets dynamiques disponibles retournés par GetMaxDynamicObjectCount à une application est égal à 0.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête spatialaudioclient.h

Voir aussi

ISpatialAudioClient