IAudioCaptureClient::GetNextPacketSize method (audioclient.h)

  • Artikel

Metode GetNextPacketSize mengambil jumlah bingkai dalam paket data berikutnya di buffer titik akhir tangkapan.

Sintaks

HRESULT GetNextPacketSize(
  [out] UINT32 *pNumFramesInNextPacket
);

Parameter

[out] pNumFramesInNextPacket

Arahkan ke variabel UINT32 tempat metode menulis jumlah bingkai (jumlah bingkai audio dalam paket pengambilan berikutnya).

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

Keterangan

Gunakan metode ini hanya dengan aliran mode bersama. Ini tidak berfungsi dengan aliran mode eksklusif.

Sebelum memanggil metode IAudioCaptureClient::GetBuffer untuk mengambil paket data berikutnya, klien dapat memanggil GetNextPacketSize untuk mengambil jumlah bingkai audio dalam paket berikutnya. Jumlah yang dilaporkan oleh GetNextPacketSize cocok dengan jumlah yang diambil dalam panggilan GetBuffer (melalui parameter output pNumFramesToRead ) yang mengikuti panggilan GetNextPacketSize .

Paket selalu terdiri dari sejumlah bingkai audio yang tidak terpisahkan.

GetNextPacketSize harus dipanggil dalam utas yang sama dengan panggilan metode GetBuffer dan IAudioCaptureClient::ReleaseBuffer yang mendapatkan dan melepaskan paket di buffer titik akhir tangkapan.

Untuk contoh kode yang menggunakan metode GetNextPacketSize, lihat Menangkap Stream.

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 IAudioCaptureClient

IAudioCaptureClient::GetBuffer

IAudioCaptureClient::ReleaseBuffer

IAudioClient::GetCurrentPadding