ISpatialAudioClient::GetStaticObjectPosition-Methode (spatialaudioclient.h)
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 |
|---|---|
|
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 |