Méthode ISpatialAudioObjectForHrtf::SetOrientation (spatialaudiohrtf.h)
Définit l’orientation dans l’espace 3D, par rapport au cadre de référence de l’écouteur, à partir duquel les données audio ISpatialAudioObjectForHrtf seront rendues.
Syntaxe
HRESULT SetOrientation(
[in] const SpatialAudioHrtfOrientation *orientation
);
Paramètres
[in] orientation
Tableau de floats définissant une matrice de rotation 3x3 de ligne majeure.
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 |
|---|---|
|
ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects n’a pas été appelé avant l’appel à SetOrientation. |
|
SetEndOfStream a été appelé explicitement ou implicitement dans une passe de traitement audio précédente. SetEndOfStream est appelé implicitement par le système si GetBuffer n’est pas appelé dans une passe de traitement audio (entre les appels à ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects et ISpatialAudioObjectsRenderStreamBase::EndUpdatingAudioObjects). |
Remarques
Si SetOrientation n’est jamais appelé, la valeur par défaut d’une matrice d’identité est utilisée. Une fois que SetOrientation est appelé, l’orientation définie est utilisée pour l’objet audio jusqu’à ce que l’orientation soit modifiée avec un autre appel à SetOrientation.
Configuration requise
| Plateforme cible | Windows |
| En-tête | spatialaudiohrtf.h |