Méthode ISpatialAudioObjectForHrtf::SetOrientation (spatialaudiohrtf.h)

Article
08/26/2023

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
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects n’a pas été appelé avant l’appel à SetOrientation.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	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

Voir aussi

ISpatialAudioObjectForHrtf

Partager via