Méthode ISpatialAudioClient ::GetMaxDynamicObjectCount (spatialaudioclient.h)
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 |