Compartir a través de

Método ISpatialAudioClient::GetStaticObjectPosition (spatialaudioclient.h)

  • Artículo

Obtiene la posición en el espacio 3D del canal de audio espacial estático especificado.

Sintaxis

HRESULT GetStaticObjectPosition(
  [in]  AudioObjectType type,
  [out] float           *x,
  [out] float           *y,
  [out] float           *z
);

Parámetros

[in] type

Valor que indica el canal de audio espacial estático para el que se consulta la posición. Este método devolverá E_INVALIDARG si el valor no representa un canal estático, incluidos AudioObjectType_Dynamic y AudioObjectType_None.

[out] x

Coordenada x del canal de audio estático, en metros, con respecto al agente de escucha. Los valores positivos están a la derecha del agente de escucha y los valores negativos están a la izquierda.

[out] y

Coordenada y del canal de audio estático, en metros, con respecto al agente de escucha. Los valores positivos están por encima del agente de escucha y los valores negativos se encuentran a continuación.

[out] z

Coordenada z del canal de audio estático, en metros, con respecto al agente de escucha. Los valores positivos están detrás del agente de escucha y los valores negativos están delante.

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
E_INVALIDARG
 El valor AudioObjectType proporcionado no representa un canal estático.

Comentarios

Los valores de posición usan un sistema de coordenadas cartesiano a la derecha, donde cada unidad representa 1 metro. El sistema de coordenadas es relativo al agente de escucha donde el origen (x=0.0, y=0.0, z=0.0) representa el punto central entre los oídos del agente de escucha.

Requisitos

   
Plataforma de destino Windows
Encabezado spatialaudioclient.h

Consulte también

ISpatialAudioClient