IAudioClock::GetFrequency method (audioclient.h)

  • Artikel

Metode GetFrequency mendapatkan frekuensi perangkat.

Sintaks

HRESULT GetFrequency(
  [out] UINT64 *pu64Frequency
);

Parameter

[out] pu64Frequency

Arahkan ke variabel UINT64 tempat metode menulis frekuensi perangkat. Untuk informasi selengkapnya, lihat Keterangan.

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
E_POINTER
 Parameter pu64Frequency adalah NULL.
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.

Keterangan

Frekuensi perangkat adalah frekuensi yang dihasilkan oleh jam perangkat keras di perangkat audio. Metode ini melaporkan frekuensi perangkat dalam unit yang kompatibel dengan posisi perangkat yang dilaporkan oleh metode IAudioClock::GetPosition . Misalnya, jika, untuk aliran tertentu, metode GetPosition mengekspresikan posisi p sebagai offset byte, metode GetFrequency mengekspresikan frekuensi f dalam byte per detik. Untuk aliran apa pun, offset dalam hitungan detik dari awal aliran selalu dapat dihitung dengan andal sebagai p/f terlepas dari unit di mana p dan f dinyatakan.

Di Windows Vista, frekuensi perangkat yang dilaporkan oleh panggilan berturut-turut ke GetFrequency tidak pernah berubah selama masa pakai aliran.

Jika jam yang dihasilkan oleh perangkat audio berjalan pada frekuensi yang konstan secara nominal, frekuensi mungkin masih sedikit bervariasi dari waktu ke waktu karena penyimpangan atau jitter sehubungan dengan jam referensi. Jam referensi mungkin jam dinding atau jam sistem yang digunakan oleh fungsi QueryPerformanceCounter . Metode GetFrequency mengabaikan variasi tersebut dan hanya melaporkan frekuensi konstan. Namun, posisi yang dilaporkan oleh metode IAudioClient::GetPosition memperhitungkan semua variasi tersebut untuk melaporkan nilai posisi yang akurat setiap kali dipanggil. Untuk informasi selengkapnya tentang QueryPerformanceCounter, lihat dokumentasi Windows SDK.

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 IAudioClock

IAudioClock::GetPosition