Struktur SpatialAudioObjectRenderStreamForMetadataActivationParams (spatialaudiometadata.h)

Mewakili parameter aktivasi untuk aliran render audio spasial untuk metadata. Teruskan struktur ini ke ISpatialAudioClient::ActivateSpatialAudioStream saat mengaktifkan aliran.

Sintaks

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

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.

MetadataFormatId

Pengidentifikasi format metadata untuk mesin penyajian spasial yang saat ini aktif.

MaxMetadataItemCount

Jumlah maksimum item metadata per bingkai.

MetadataActivationParams

Parameter aktivasi tambahan.

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.

Persyaratan

Persyaratan	Nilai
Header	spatialaudiometadata.h