Metode ISpatialAudioMetadataReader::ReadNextItemCommand (spatialaudiometadata.h)

Artikel
03/04/2024

Membaca perintah metadata dan data nilai untuk item saat ini.

Sintaks

HRESULT ReadNextItemCommand(
  [out] BYTE   *commandID,
  [in]  void   *valueBuffer,
  [in]  UINT32 maxValueBufferLength,
  [out] UINT32 *valueBufferLength
);

Parameter

[out] commandID

Menerima ID perintah untuk perintah saat ini.

[in] valueBuffer

Penunjuk ke buffer yang menerima data khusus untuk perintah seperti yang ditentukan oleh definisi format metadata. Buffer harus setidaknya maxValueBufferLength untuk memastikan semua perintah dapat berhasil diambil.

[in] maxValueBufferLength

Ukuran maksimum nilai perintah.

[out] valueBufferLength

Ukuran, dalam byte, dari data yang ditulis ke parameter valueBuffer .

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.
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 lalu memanggil ReadNextItem 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

Persyaratan	Nilai
Target Platform	Windows
Header	spatialaudiometadata.h

Lihat juga

ISpatialAudioMetadataReader

Bagikan melalui