IAudioClient::Metode GetStreamLatency (audioclient.h)

  • Artikel

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
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
 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

Lihat juga

Antarmuka IAudioClient

IAudioClient::Initialize

IAudioRenderClient::GetBuffer