Metode IXAudio2SourceVoice::GetState (xaudio2.h)

Mengembalikan data posisi kursor suara saat ini.

Sintaks

void GetState(
             XAUDIO2_VOICE_STATE *pVoiceState,
  [optional] UINT32              Flags
);

Parameter

pVoiceState

Penunjuk ke struktur XAUDIO2_VOICE_STATE yang berisi status suara.

[optional] Flags

Bendera yang mengontrol data status suara mana yang harus dikembalikan. Nilai yang valid adalah 0 atau XAUDIO2_VOICE_NOSAMPLESPLAYED. Nilai default adalah 0. Jika Anda menentukan XAUDIO2_VOICE_NOSAMPLESPLAYED, GetState hanya mengembalikan status buffer, bukan status sampler. GetState membutuhkan waktu sekitar sepertiga untuk menyelesaikannya saat Anda menentukan XAUDIO2_VOICE_NOSAMPLESPLAYED.

Mengembalikan nilai

Tidak ada

Keterangan

Jika klien perlu mendapatkan posisi yang berkorelasi dari beberapa suara (misalnya, untuk mengetahui dengan tepat sampel suara tertentu yang diputar ketika sampel tertentu dari suara lain diputar), itu harus melakukan panggilan GetState dalam panggilan balik mesin XAudio2. Ini memastikan bahwa tidak ada suara yang maju saat panggilan sedang dilakukan. Lihat gambaran umum Panggilan Balik XAudio2 untuk informasi tentang menggunakan panggilan balik XAudio2.

Perhatikan bahwa versi DirectX SDK dari XAUDIO2 tidak mengambil parameter Bendera untuk GetState.

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: Stream Suara dari Disk

IXAudio2SourceVoice