Metode ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)

Artikel
03/15/2023

Mengaktifkan ISpatialAudioObjectForHrtf untuk penyajian audio.

Sintaks

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **audioObject
);

Parameter

[in] type

Jenis objek audio yang akan diaktifkan. Untuk objek audio dinamis, nilai ini harus AudioObjectType_Dynamic. Untuk objek audio statis, tentukan salah satu nilai saluran audio statis dari enumerasi. Menentukan AudioObjectType_None akan menghasilkan objek audio yang tidak spasial.

[out] audioObject

Menerima penunjuk ke antarmuka yang diaktifkan.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
SPTLAUDCLNT_E_NO_MORE_OBJECTS	Sistem telah mencapai jumlah maksimum objek audio simultan.
SPTLAUDCLNT_E_DESTROYED	ISpatialAudioClient yang terkait dengan aliran audio spasial telah dihancurkan.
AUDCLNT_E_DEVICE_INVALIDATED	Perangkat titik akhir audio telah dicabut, atau perangkat keras audio atau sumber daya perangkat keras terkait telah dikonfigurasi ulang, dinonaktifkan, dihapus, atau tidak tersedia untuk digunakan.
SPTLAUDCLNT_E_INTERNAL	Terjadi kesalah internal.
AUDCLNT_E_UNSUPPORTED_FORMAT	Media yang terkait dengan aliran audio spasial menggunakan format yang tidak didukung.

Keterangan

ISpatialAudioObjectForHrtf dinamis adalah salah satu yang diaktifkan dengan mengatur parameter jenis ke metode ActivateSpatialAudioObjectForHrtf ke AudioObjectType_Dynamic. Klien memiliki batas jumlah maksimum objek audio spasial dinamis yang dapat diaktifkan pada satu waktu. Setelah batas tercapai, mencoba mengaktifkan objek audio tambahan akan mengakibatkan metode ini mengembalikan kesalahan SPTLAUDCLNT_E_NO_MORE_OBJECTS. Untuk menghindari hal ini, panggil Rilis pada setiap ISpatialAudioObjectForHrtf dinamis setelah tidak lagi digunakan untuk membebaskan sumber daya sehingga dapat direalokasikan. Lihat ISpatialAudioObjectgBase::IsActive dan ISpatialAudioObjectgBase::SetEndOfStream untuk informasi selengkapnya tentang mengelola masa pakai objek audio spasial.

Persyaratan


Target Platform	Windows
Header	spatialaudiohrtf.h

Lihat juga

ISpatialAudioRenderStreamForHrtf

Bagikan melalui