Metode ISpatialAudioClient2::GetMaxFrameCountForCategory (spatialaudioclient.h)

Artikel
03/02/2024

Mendapatkan jumlah bingkai maksimum yang didukung per lulus pemrosesan.

Sintaks

HRESULT GetMaxFrameCountForCategory(
  [in]  AUDIO_STREAM_CATEGORY category,
  [in]  BOOL                  offloadEnabled,
  [in]  const WAVEFORMATEX    *objectFormat,
  [out] UINT32                *frameCountPerBuffer
);

Parameter

[in] category

AUDIO_STREAM_CATEGORY (audiosessiontypes.h) aliran audio yang dukungannya dikueri.

[in] offloadEnabled

Nilai boolean yang menentukan apakah jumlah bingkai yang dikembalikan harus dihitung dengan dukungan offload audio yang dipertimbangkan. Jika bendera ini diatur ke true, jumlah bingkai yang dikembalikan adalah apa jadinya jika aliran diaktifkan untuk mode offload. Namun, jika bendera ini diatur ke true tetapi titik akhir audio tidak mendukung mode offload, maka bendera tidak berpengaruh. Gunakan ISpatialAudioClient2::IsOffloadCapable untuk memeriksa apakah mode offload didukung.

[in] objectFormat

Penunjuk ke struktur WAVEFORMATEX (mmeapi.h) yang menentukan format aliran audio yang dukungannya dikueri.

[out] frameCountPerBuffer

Menerima pointer ke INT32 yang menunjukkan jumlah bingkai maksimum yang didukung untuk perangkat audio dan parameter input yang ditentukan.

Nilai kembali

HRESULT termasuk nilai berikut.

Nilai	Deskripsi
S_OK	Berhasil
AUDCLNT_E_DEVICE_INVALIDATED	Perangkat audio yang terkait dengan klien audio tidak valid.

Keterangan

Nilai yang dikembalikan oleh metode ini dapat digunakan untuk mengalokasikan buffer sumber. Nilai ini akan berubah jika irama titik akhir berubah. Pemanggil harus menentukan nilai AUDIO_STREAM_CATEGORY dan WAVEFORMATEX yang sama yang akan digunakan saat membuat aliran. Parameter offloadEnabled harus diatur ke TRUE jika aliran akan dibuat dengan bendera SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD .

Persyaratan

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

Bagikan melalui