Metode ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject (spatialaudioclient.h)

Mengaktifkan ISpatialAudioObject untuk penyajian audio.

Sintaks

HRESULT ActivateSpatialAudioObject(
  [in]  AudioObjectType     type,
  [out] ISpatialAudioObject **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.

Mengembalikan 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

ISpatialAudioObject dinamis adalah salah satu yang diaktifkan dengan mengatur parameter jenis ke metode ActivateSpatialAudioObject 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 ISpatialAudioObject dinamis setelah tidak lagi digunakan untuk membebaskan sumber daya sehingga dapat dialokasikan kembali. Lihat ISpatialAudioObject::IsActive dan ISpatialAudioObject::SetEndOfStream untuk informasi selengkapnya tentang mengelola masa pakai objek audio spasial.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	spatialaudioclient.h

Lihat juga

ISpatialAudioObjectRenderStream