Metode ISpatialAudioClient::GetStaticObjectPosition (spatialaudioclient.h)

Mendapatkan posisi dalam ruang 3D dari saluran audio spasial statis yang ditentukan.

Sintaks

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

Parameter

[in] type

Nilai yang menunjukkan saluran audio spasial statis tempat posisi sedang dikueri. Metode ini akan mengembalikan E_INVALIDARG jika nilai tidak mewakili saluran statis, termasuk AudioObjectType_Dynamic dan AudioObjectType_None.

[out] x

Koordinat x saluran audio statis, dalam meter, relatif terhadap pendengar. Nilai positif berada di sebelah kanan pendengar dan nilai negatif berada di sebelah kiri.

[out] y

Koordinat y saluran audio statis, dalam meter, relatif terhadap pendengar. Nilai positif berada di atas pendengar dan nilai negatif ada di bawah ini.

[out] z

Koordinat z saluran audio statis, dalam meter, relatif terhadap pendengar. Nilai positif berada di belakang pendengar dan nilai negatif ada di depan.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Nilai AudioObjectType yang disediakan tidak mewakili saluran statis.

Keterangan

Nilai posisi menggunakan sistem koordinat Kartesius tangan kanan, di mana setiap unit mewakili 1 meter. Sistem koordinat relatif terhadap pendengar tempat asal (x=0,0, y=0,0, z=0,0) mewakili titik tengah antara telinga pendengar.

Persyaratan

Target Platform	Windows
Header	spatialaudioclient.h

Lihat juga

ISpatialAudioClient