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

Définit le modèle de directivité audio spatiale pour ISpatialAudioObjectForHrtf.

Syntaxe

HRESULT SetDirectivity(
  SpatialAudioHrtfDirectivityUnion *directivity
);

Paramètres

directivity

Modèle de directivité audio spatiale. Cette valeur peut être l’une des structures suivantes :

• SpatialAudioHrtfDirectivity
• SpatialAudioHrtfDirectivityCardioid
• SpatialAudioHrtfDirectivityCone

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 à SetDirectivity.
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

La structure SpatialAudioHrtfDirectivity représente un modèle omnidirectionnel qui peut être interpolé de manière linéaire avec un modèle cardioïde ou cône.

Si SetDirectivity n’est pas appelé, le type par défaut de SpatialAudioHrtfDirectivity_OmniDirectional est utilisé sans interpolation.

Configuration requise

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

Voir aussi

ISpatialAudioObjectForHrtf