Compartilhar via

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

  • Artigo

Obtém a posição no espaço 3D do canal de áudio espacial estático especificado.

Sintaxe

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

Parâmetros

[in] type

Um valor que indica o canal de áudio espacial estático para o qual a posição está sendo consultada. Esse método retornará E_INVALIDARG se o valor não representar um canal estático, incluindo AudioObjectType_Dynamic e AudioObjectType_None.

[out] x

A coordenada x do canal de áudio estático, em metros, em relação ao ouvinte. Os valores positivos estão à direita do ouvinte e os valores negativos estão à esquerda.

[out] y

A coordenada y do canal de áudio estático, em metros, em relação ao ouvinte. Os valores positivos estão acima do ouvinte e os valores negativos estão abaixo.

[out] z

A coordenada z do canal de áudio estático, em metros, em relação ao ouvinte. Os valores positivos estão por trás do ouvinte e os valores negativos estão na frente.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_INVALIDARG
 O valor de AudioObjectType fornecido não representa um canal estático.

Comentários

Os valores de posição usam um sistema de coordenadas cartesiano destro, em que cada unidade representa 1 metro. O sistema de coordenadas é relativo ao ouvinte em que a origem (x=0,0, y=0,0, z=0,0) representa o ponto central entre os ouvidos do ouvinte.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho spatialaudioclient.h

Confira também

ISpatialAudioClient