Bagikan melalui

Struktur SpatialAudioObjectRenderStreamActivationParams2 (spatialaudioclient.h)

  • Artikel

Mewakili parameter aktivasi untuk aliran render audio spasial, memperluas SpatialAudioObjectRenderStreamActivationParams (spatialaudioclient.h) dengan kemampuan untuk menentukan opsi streaming. Teruskan struktur ini ke ISpatialAudioClient::ActivateSpatialAudioStream saat mengaktifkan aliran.

Sintaks

typedef struct SpatialAudioObjectRenderStreamActivationParams2 {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
  SPATIAL_AUDIO_STREAM_OPTIONS          Options;
} SpatialAudioObjectRenderStreamActivationParams2;

Anggota

ObjectFormat

Format deskriptor untuk satu objek audio spasial. Semua objek yang digunakan oleh aliran harus memiliki format yang sama dan formatnya harus berjenis WAVEFORMATEX atau WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Kombinasi bitwise dari nilai AudioObjectType yang menunjukkan kumpulan saluran audio spasial statis yang akan diizinkan oleh aliran yang diaktifkan.

MinDynamicObjectCount

Jumlah minimum objek dinamis bersamaan. Jika jumlah objek audio dinamis ini tidak dapat diaktifkan secara bersamaan, ISpatialAudioClient::ActivateSpatialAudioStream akan gagal dengan kesalahan ini SPTLAUDCLNT_E_NO_MORE_OBJECTS.

MaxDynamicObjectCount

Jumlah maksimum objek dinamis bersamaan yang dapat diaktifkan dengan ISpatialAudioObjectRenderStream.

Category

Kategori aliran audio dan objek audio spasialnya.

EventHandle

Peristiwa yang akan memberi sinyal kepada klien untuk memberikan lebih banyak data audio. Handel ini akan diduplikasi secara internal sebelum digunakan.

NotifyObject

Objek yang menyediakan pemberitahuan bagi klien audio spasial untuk merespons perubahan status ISpatialAudioObjectRenderStream. Objek ini digunakan untuk memberi tahu klien bahwa jumlah objek audio spasial dinamis yang dapat diaktifkan secara bersamaan akan berubah.

Options

Anggota emumerasi SPATIAL_AUDIO_STREAM_OPTIONS , menentukan opsi untuk aliran audio yang diaktifkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Build 22000
Header spatialaudioclient.h