Méthode ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)
Active un ISpatialAudioObjectForHrtf pour le rendu audio.
Syntaxe
HRESULT ActivateSpatialAudioObjectForHrtf(
[in] AudioObjectType type,
[out] ISpatialAudioObjectForHrtf **audioObject
);
Paramètres
[in] type
Type d’objet audio à activer. Pour les objets audio dynamiques, cette valeur doit être AudioObjectType_Dynamic. Pour les objets audio statiques, spécifiez l’une des valeurs de canal audio statique de l’énumération. La spécification de AudioObjectType_None génère un objet audio qui n’est pas spatialisé.
[out] audioObject
Reçoit un pointeur vers l’interface activée.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
Code de retour | Description |
---|---|
|
Le système a atteint le nombre maximal d’objets audio simultanés. |
|
L’ISpatialAudioClient associé au flux audio spatial a été détruit. |
|
Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement rendus indisponibles. |
|
Une erreur interne s'est produite. |
|
Le média associé au flux audio spatial utilise un format non pris en charge. |
Remarques
Un ISpatialAudioObjectForHrtf dynamique a été activé en définissant le paramètre type sur la méthode ActivateSpatialAudioObjectForHrtf pour AudioObjectType_Dynamic. Le client a une limite du nombre maximal d’objets audio spatiaux dynamiques qui peuvent être activés à la fois. Une fois la limite atteinte, la tentative d’activation d’objets audio supplémentaires entraîne le renvoi d’une erreur SPTLAUDCLNT_E_NO_MORE_OBJECTS par cette méthode. Pour éviter cela, appelez Release sur chaque ISpatialAudioObjectForHrtf dynamique après qu’il n’est plus utilisé pour libérer la ressource afin qu’elle puisse être réaffectée. Consultez ISpatialAudioObjectgBase::IsActive et ISpatialAudioObjectgBase::SetEndOfStream pour plus d’informations sur la gestion de la durée de vie des objets audio spatiaux.
Configuration requise
Plateforme cible | Windows |
En-tête | spatialaudiohrtf.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour