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

Establece el modelo de directividad de audio espacial para ISpatialAudioObjectForHrtf.

Sintaxis

HRESULT SetDirectivity(
  SpatialAudioHrtfDirectivityUnion *directivity
);

Parámetros

directivity

Modelo de directividad de audio espacial. Este valor puede ser una de las siguientes estructuras:

• SpatialAudioHrtfDirectivity
• SpatialAudioHrtfDirectivityCardioid
• SpatialAudioHrtfDirectivityCone

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
SPTLAUDCLNT_E_OUT_OF_ORDER	No se llamó a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects antes de la llamada a SetDirectivity.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	Se llamó a SetEndOfStream de forma explícita o implícita en un paso de procesamiento de audio anterior. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Comentarios

La estructura SpatialAudioHrtfDirectivity representa un modelo omnidireccional que se puede interpolar linealmente con un modelo cardioide o cono.

Si no se llama a SetDirectivity , se usa el tipo predeterminado de SpatialAudioHrtfDirectivity_OmniDirectional sin interpolación.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	spatialaudiohrtf.h

Consulte también

ISpatialAudioObjectForHrtf