Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |