ISpatialAudioObjectForHrtf::SetOrientation-Methode (spatialaudiohrtf.h)

  • Artikel

Legt die Ausrichtung im 3D-Raum relativ zum Bezugsrahmen des Listeners fest, aus dem die ISpatialAudioObjectForHrtf-Audiodaten gerendert werden.

Syntax

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

Parameter

[in] orientation

Ein Array von Floats, das zeilenmastige 3x3-Rotationsmatrix definiert.

Rückgabewert

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

Rückgabecode Beschreibung
SPTLAUDCLNT_E_OUT_OF_ORDER

ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects wurde vor dem Aufruf von SetOrientation nicht aufgerufen.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED

SetEndOfStream wurde in einem vorherigen Audioverarbeitungsdurchlauf explizit oder implizit aufgerufen. SetEndOfStream wird implizit vom System aufgerufen, wenn GetBuffer nicht innerhalb eines Audioverarbeitungsdurchlaufs aufgerufen wird (zwischen Aufrufen von ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects und ISpatialAudioObjectRenderStreamBase:EndUpdatingAudioObjects).

Hinweise

Wenn SetOrientation nie aufgerufen wird, wird der Standardwert einer Identitätsmatrix verwendet. Nachdem SetOrientation aufgerufen wurde, wird die festgelegte Ausrichtung für das Audioobjekt verwendet, bis die Ausrichtung mit einem weiteren Aufruf von SetOrientation geändert wird.

Anforderungen

   
Zielplattform Windows
Kopfzeile spatialaudiohrtf.h

Weitere Informationen

ISpatialAudioObjectForHrtf