IAudioClient::Metode GetStreamLatency (audioclient.h)
Metode GetStreamLatency mengambil latensi maksimum untuk aliran saat ini dan dapat dipanggil kapan saja setelah aliran diinisialisasi.
Sintaks
HRESULT GetStreamLatency(
[out] REFERENCE_TIME *phnsLatency
);
Parameter
[out] phnsLatency
Penunjuk ke variabel REFERENCE_TIME tempat metode menulis nilai waktu yang mewakili latensi. Waktu dinyatakan dalam unit 100 nanodetik. Untuk informasi selengkapnya tentang REFERENCE_TIME, lihat dokumentasi Windows SDK.
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 |
|---|---|
|
Aliran audio belum berhasil diinisialisasi. |
|
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. |
|
Layanan audio Windows tidak berjalan. |
|
PhnsLatency parameter adalah NULL. |
Keterangan
Metode ini memerlukan inisialisasi sebelumnya dari antarmuka IAudioClient . Semua panggilan ke metode ini akan gagal dengan kesalahan AUDCLNT_E_NOT_INITIALIZED sampai klien menginisialisasi aliran audio dengan berhasil memanggil metode IAudioClient::Initialize .
Metode ini mengambil latensi maksimum untuk aliran saat ini. Nilai tidak akan berubah selama masa pakai objek IAudioClient .
Klien rendering dapat menggunakan nilai latensi ini untuk menghitung jumlah minimum data yang dapat mereka tulis selama satu proses lulus. Untuk menulis kurang dari minimum ini adalah dengan risiko memperkenalkan gangguan ke dalam aliran audio. Untuk informasi selengkapnya, lihat IAudioRenderClient::GetBuffer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | audioclient.h |