Metode ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)

Artikel
03/15/2023

Mendapatkan jumlah perintah dan offset sampel untuk item metadata yang sedang dibaca.

Sintaks

HRESULT ReadNextItem(
  [out] UINT8  *commandCount,
  [out] UINT16 *frameOffset
);

Parameter

[out] commandCount

Menerima jumlah pasangan perintah/nilai dalam item metadata yang sedang dibaca.

[out] frameOffset

Mendapatkan offset bingkai yang terkait dengan item metadata yang sedang dibaca.

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
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems belum dibuka untuk dibaca dengan panggilan ke Buka atau objek telah ditutup untuk ditulis dengan panggilan ke Tutup.
SPTLAUD_MD_CLNT_E_NO_MORE_ITEMS	Tidak ada lagi item metadata dalam rentang bingkai yang ditentukan dalam panggilan ke ReadItemCountInFrames.
E_INVALIDARG	Salah satu pointer yang disediakan tidak valid.

Keterangan

Sebelum memanggil ReadNextItem, Anda harus membuka ISpatialAudioMetadataReader untuk dibaca dengan memanggil Buka setelah objek dibuat dan setelah Tutup dipanggil. Anda juga harus memanggil ReadItemCountInFrames sebelum memanggil ReadNextItem.

ISpatialAudioMetadataReader menyimpan pointer internal ke posisi saat ini dalam rentang total bingkai yang dimuat oleh ISpatialAudioMetadataItems yang terkait dengan pembaca. Setiap panggilan ke metode ini menyebabkan penunjuk ditingkatkan dengan jumlah bingkai yang ditentukan dalam parameter readFrameCount .

Proses untuk membaca perintah dan nilai terkait bersifat rekursif. Setelah setiap panggilan ke ReadItemCountInFrames, panggil ReadNextItem untuk mendapatkan jumlah perintah di item berikutnya. Setelah setiap panggilan ke ReadNextItem, panggil ReadNextItemCommand untuk membaca setiap perintah untuk item tersebut. Ulangi proses ini hingga seluruh rentang bingkai ISpatialAudioMetadataItems telah dibaca.

Persyaratan


Target Platform	Windows
Header	spatialaudiometadata.h

Lihat juga

ISpatialAudioMetadataReader

Bagikan melalui