Bagikan melalui

struktur XAUDIO2_VOICE_STATE (xaudio2.h)

  • Artikel

Mengembalikan data status suara dan posisi kursor saat ini.

Sintaks

typedef struct XAUDIO2_VOICE_STATE {
  void   *pCurrentBufferContext;
  UINT32 BuffersQueued;
  UINT64 SamplesPlayed;
} XAUDIO2_VOICE_STATE;

Anggota

pCurrentBufferContext

Arahkan ke konteks buffer yang disediakan dalam XAUDIO2_BUFFER yang saat ini diproses, atau, jika suara dihentikan saat ini, ke buffer berikutnya karena diproses. pCurrentBufferContext adalah NULL jika tidak ada buffer dalam antrean.

BuffersQueued

Jumlah buffer audio yang saat ini diantrekan pada suara, termasuk yang saat ini diproses.

SamplesPlayed

Jumlah total sampel yang diproses oleh suara ini sejak terakhir kali dimulai, atau sejak aliran audio terakhir berakhir (sebagaimana ditandai dengan bendera XAUDIO2_END_OF_STREAM). Total ini mencakup sampel yang dimainkan beberapa kali karena perulangan. Secara teoritis, jika semua audio yang dipancarkan oleh suara hingga saat ini diambil, parameter ini akan menjadi panjang aliran audio dalam sampel. Jika Anda menentukan XAUDIO2_VOICE_NOSAMPLESPLAYED saat Anda memanggil IXAudio2SourceVoice::GetState, anggota ini tidak akan dihitung, dan nilainya tidak ditentukan saat kembali dari IXAudio2SourceVoice::GetState. IXAudio2SourceVoice::GetState membutuhkan waktu sekitar sepertiga untuk diselesaikan ketika Anda menentukan XAUDIO2_VOICE_NOSAMPLESPLAYED.

Keterangan

Untuk semua format yang dikodekan, termasuk format laju bit konstan (CBR) seperti modulasi kode pulsa diferensial adaptif (ADPCM), SamplesPlayed dinyatakan dalam hal sampel yang didekodekan. Untuk format modulasi kode pulsa (PCM), SamplesPlayed dinyatakan dalam hal sampel input atau output. Ada pemetaan satu-ke-satu dari input ke output untuk format PCM.

Jika klien perlu mendapatkan posisi yang berkorelasi dari beberapa suara—yaitu, untuk mengetahui dengan tepat sampel suara tertentu yang diputar ketika sampel tertentu dari suara lain diputar—itu harus membuat panggilan IXAudio2SourceVoice::GetState dalam panggilan balik mesin XAudio2. Melakukan ini memastikan bahwa tidak ada suara yang maju saat panggilan dilakukan.

Persyaratan Platform

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

Persyaratan

   
Header xaudio2.h

Lihat juga

Struktur