IAudioClient::Metode mulai (audioclient.h)

  • Artikel

Metode Mulai memulai aliran audio.

Sintaks

HRESULT Start();

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
AUDCLNT_E_NOT_INITIALIZED
 Aliran audio belum berhasil diinisialisasi.
AUDCLNT_E_NOT_STOPPED
 Aliran audio tidak dihentikan pada saat panggilan Mulai .
AUDCLNT_E_EVENTHANDLE_NOT_SET
 Aliran audio dikonfigurasi untuk menggunakan buffering berbasis peristiwa, tetapi pemanggil belum memanggil IAudioClient::SetEventHandle untuk mengatur penanganan aktivitas pada aliran.
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 dibuat tidak tersedia untuk digunakan.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Layanan audio Windows tidak berjalan.

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 .

Start adalah metode kontrol yang dipanggil klien untuk memulai aliran audio. Memulai aliran menyebabkan objek IAudioClient memulai streaming data antara buffer titik akhir dan mesin audio. Ini juga menyebabkan jam audio aliran melanjutkan penghitungan dari posisinya saat ini.

Pertama kali metode ini disebut mengikuti inisialisasi aliran, penghitung posisi aliran objek IAudioClient dimulai pada 0. Jika tidak, jam dilanjutkan dari posisinya pada saat aliran terakhir dihentikan. Mengatur ulang aliran memaksa posisi aliran kembali ke 0.

Untuk menghindari gangguan start-up dengan aliran penyajian, klien tidak boleh memanggil Mulai sampai mesin audio awalnya dimuat dengan data dengan memanggil metode IAudioRenderClient::GetBuffer dan IAudioRenderClient::ReleaseBuffer pada antarmuka penyajian.

Untuk contoh kode yang memanggil metode Mulai , lihat topik berikut:

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

IAudioRenderClient::ReleaseBuffer