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

Define a orientação no espaço 3D em relação ao quadro de referência do ouvinte, do qual os dados de áudio ISpatialAudioObjectForHrtf serão renderizados.

Sintaxe

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

Parâmetros

[in] orientation

Uma matriz de floats que definem a matriz de rotação 3x3 principal da linha.

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
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects não foi chamado antes da chamada para SetOrientation.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream foi chamado explicitamente ou implicitamente em uma passagem de processamento de áudio anterior. SetEndOfStream será chamado implicitamente pelo sistema se GetBuffer não for chamado dentro de uma passagem de processamento de áudio (entre chamadas para ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Comentários

Se SetOrientation nunca for chamado, o valor padrão de uma matriz de identidade será usado. Depois que SetOrientation for chamado, a orientação definida será usada para o objeto de áudio até que a orientação seja alterada com outra chamada para SetOrientation.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	spatialaudiohrtf.h

Confira também

ISpatialAudioObjectForHrtf