ISpatialAudioClient::GetStaticObjectPosition-Methode (spatialaudioclient.h)

  • Artikel

Ruft die Position des angegebenen statischen räumlichen Audiokanals im 3D-Bereich ab.

Syntax

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

Parameter

[in] type

Ein Wert, der den statischen räumlichen Audiokanal angibt, für den die Position abgefragt wird. Diese Methode gibt E_INVALIDARG zurück, wenn der Wert keinen statischen Kanal darstellt, einschließlich AudioObjectType_Dynamic und AudioObjectType_None.

[out] x

Die x-Koordinate des statischen Audiokanals in Metern relativ zum Listener. Positive Werte befinden sich rechts vom Listener und negative Werte auf der linken Seite.

[out] y

Die y-Koordinate des statischen Audiokanals in Metern relativ zum Listener. Positive Werte befinden sich über dem Listener und negative Werte darunter.

[out] z

Die z-Koordinate des statischen Audiokanals in Metern relativ zum Listener. Positive Werte befinden sich hinter dem Listener und negative Werte vorn.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_INVALIDARG
 Der angegebene AudioObjectType-Wert stellt keinen statischen Kanal dar.

Hinweise

Positionswerte verwenden ein rechtshändiges kartesisches Koordinatensystem, wobei jede Einheit 1 Meter darstellt. Das Koordinatensystem ist relativ zum Listener, bei dem der Ursprung (x=0,0, y=0,0, z=0,0) den Mittelpunkt zwischen den Ohren des Listeners darstellt.

Anforderungen

   
Zielplattform Windows
Kopfzeile spatialaudioclient.h

Weitere Informationen

ISpatialAudioClient