Metode IXAudio2VoiceCallback::OnBufferStart (xaudio2.h)

Dipanggil saat suara akan mulai memproses buffer audio baru.

Sintaks

void OnBufferStart(
  void *pBufferContext
);

Parameter

pBufferContext

Penunjuk konteks yang ditetapkan ke anggota pContext dari struktur XAUDIO2_BUFFER saat buffer dikirimkan.

Mengembalikan nilai

Tidak ada

Keterangan

pBufferContext adalah penunjuk konteks yang awalnya disediakan oleh anggota pContext dari struktur XAUDIO2_BUFFER , yang mungkin NULL.

OnBufferStart dijamin akan dipanggil tepat sebelum byte pertama buffer saat ini digunakan. Sangat tepat untuk menggunakan panggilan balik ini untuk perubahan pada status suara seperti berikut ini.

• Mengirimkan buffer baru ke suara
• Menyesuaikan parameter volume, nada, dan efek suara
• Mengaktifkan atau menonaktifkan efek dalam rantai efek suara

Semua tindakan yang tercantum di atas sinkron ketika dilakukan dalam panggilan balik XAudio2, sehingga perubahan akan segera berlaku, memengaruhi buffer yang akan dimulai.

Anda juga dapat menggunakan panggilan balik ini untuk menulis data audio ke buffer secara langsung, yang dapat berguna untuk skenario streaming latensi rendah. Namun, seperti semua panggilan balik XAudio2, tidak ada pekerjaan yang harus dilakukan yang menggunakan sejumlah besar waktu prosesor atau dapat memblokir eksekusi, termasuk disk sinkron atau pembacaan jaringan.

Untuk informasi tentang metode antarmuka IXAudio2VoiceCallback , lihat bagian Panggilan Balik XAudio2 .

Persyaratan Platform

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	xaudio2.h

Lihat juga

Cara: Menggunakan Panggilan Balik Suara Sumber

IXAudio2VoiceCallback

Panggilan Balik XAudio2