ISpatialAudioObjectForHrtf::SetOrientation-Methode (spatialaudiohrtf.h)
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 |
|---|---|
|
ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects wurde vor dem Aufruf von SetOrientation nicht aufgerufen. |
|
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 |