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

Establece la orientación en el espacio 3D, en relación con el marco de referencia del agente de escucha, desde el que se representarán los datos de audio ISpatialAudioObjectForHrtf .

Sintaxis

HRESULT SetOrientation(
  [in] const SpatialAudioHrtfOrientation *orientation
);

Parámetros

[in] orientation

Matriz de floats que define la matriz de rotación principal de fila 3x3.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, 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 SetOrientation.
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

Si nunca se llama a SetOrientation , se usa el valor predeterminado de una matriz de identidad. Después de llamar a SetOrientation , la orientación establecida se usará para el objeto de audio hasta que se cambie la orientación con otra llamada a SetOrientation.

Requisitos

Plataforma de destino	Windows
Encabezado	spatialaudiohrtf.h

Consulte también

ISpatialAudioObjectForHrtf