Metodo ISpatialAudioClient::GetStaticObjectPosition (spatialaudioclient.h)

Articolo
08/26/2023

Ottiene la posizione nello spazio 3D del canale audio spaziale statico specificato.

Sintassi

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

Parametri

[in] type

Valore che indica il canale audio spaziale statico per il quale viene eseguita la query sulla posizione. Questo metodo restituirà E_INVALIDARG se il valore non rappresenta un canale statico, inclusi AudioObjectType_Dynamic e AudioObjectType_None.

[out] x

Coordinata x del canale audio statico, in metri, rispetto al listener. I valori positivi sono a destra del listener e i valori negativi sono a sinistra.

[out] y

Coordinata y del canale audio statico, in metri, rispetto al listener. I valori positivi sono superiori al listener e i valori negativi sono riportati di seguito.

[out] z

Coordinata z del canale audio statico, in metri, rispetto al listener. I valori positivi si trovano dietro il listener e i valori negativi si trovano davanti.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_INVALIDARG	Il valore AudioObjectType fornito non rappresenta un canale statico.

Commenti

I valori di posizione usano un sistema di coordinate cartesiano a destra, dove ogni unità rappresenta 1 metro. Il sistema di coordinate è relativo al listener in cui l'origine (x=0,0, y=0,0, z=0,0) rappresenta il punto centrale tra le orecchie del listener.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	spatialaudioclient.h

Vedi anche

ISpatialAudioClient

Condividi tramite