IAudioSessionManager::GetSimpleAudioVolume method (audiopolicy.h)

Artikel
02/23/2024

Metode GetSimpleAudioVolume mengambil kontrol volume audio sederhana.

Sintaks

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

Parameter

[in] AudioSessionGuid

Arahkan ke GUID sesi. Jika GUID tidak mengidentifikasi sesi yang sebelumnya telah dibuka, panggilan akan membuka sesi baru tetapi kosong. Program Sndvol tidak menampilkan kontrol tingkat volume untuk sesi kecuali berisi satu atau beberapa aliran aktif. Jika parameter ini NULL atau menunjuk ke nilai GUID_NULL, metode menetapkan aliran ke sesi default.

[in] StreamFlags

Menentukan apakah permintaan adalah untuk sesi lintas proses. Atur ke TRUE jika sesi bersifat lintas proses. Atur ke FALSE jika sesi tidak lintas proses.

[out] AudioVolume

Arahkan ke variabel pointer tempat metode menulis penunjuk ke antarmuka ISimpleAudioVolume dari objek kontrol volume audio. Antarmuka ini mewakili kontrol volume audio sederhana untuk proses saat ini. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan Aktifkan gagal, *AudioVolume adalah NULL.

Nilai kembali

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
AUDCLNT_E_NOT_INITIALIZED	Aliran audio belum berhasil diinisialisasi.
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.
AUDCLNT_E_SERVICE_NOT_RUNNING	Layanan audio Windows tidak berjalan.
E_POINTER	Parameter AudioVolume adalah NULL.
E_MEMORY	Kehabisan memori.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	audiopolicy.h

Lihat juga

Antarmuka IAudioSessionManager

Antarmuka ISimpleAudioVolume

Bagikan melalui