Metode ISpatialAudioClient::GetMaxDynamicObjectCount (spatialaudioclient.h)

Mendapatkan jumlah maksimum objek audio dinamis untuk klien audio spasial.

Sintaks

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

Parameter

[out] value

Mendapatkan jumlah objek dinamis maksimum untuk klien ini.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK.

Keterangan

ISpatialAudioObject dinamis adalah salah satu yang diaktifkan dengan mengatur parameter jenis ke metode ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject ke AudioObjectType_Dynamic. Klien memiliki batas jumlah maksimum objek audio spasial dinamis yang dapat diaktifkan pada satu waktu. Ketika kapasitas alur penyajian audio berubah, sistem akan secara dinamis menyesuaikan jumlah maksimum objek audio spasial dinamis bersamaan. Sebelum melakukannya, sistem akan memanggil OnAvailableDynamicObjectCountChange untuk memberi tahu klien tentang perubahan batas sumber daya.

Rilis Panggilan pada ISpatialAudioObject ketika tidak lagi digunakan untuk membebaskan sumber daya untuk membuat objek audio spasial dinamis baru.

Ketika Windows Sonic tidak tersedia (misalnya, saat bermain ke speaker stereo laptop yang disematkan, atau jika pengguna belum mengaktifkan Windows Sonic secara eksplisit pada perangkat), jumlah objek dinamis yang tersedia yang dikembalikan oleh GetMaxDynamicObjectCount ke aplikasi akan menjadi 0.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	spatialaudioclient.h

Lihat juga

ISpatialAudioClient