Bagikan melalui


Metode ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

Menulis perintah metadata dan data nilai ke item saat ini.

Sintaks

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

Parameter

[in] commandID

Perintah yang didukung oleh format metadata objek. Panggilan akan gagal jika perintah tidak ditentukan oleh format metadata. Setiap perintah hanya dapat ditulis sekali per item.

[in] valueBuffer

Penunjuk ke buffer yang menyimpan data khusus untuk perintah seperti yang ditentukan oleh definisi format metadata.

[in] valueBufferLength

Ukuran, dalam byte, dari data perintah yang disediakan dalam parameter valueBuffer . Ukuran harus cocok dengan definisi perintah yang ditentukan oleh format metadata atau panggilan akan gagal.

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 ditulis dengan panggilan ke Buka atau objek telah ditutup untuk ditulis dengan panggilan ke Tutup.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

WriteNextItem tidak dipanggil setelah Open dipanggil dan sebelum panggilan ke WriteNextItemCommand.

Keterangan

Anda harus membuka ISpatialAudioMetadataWriter untuk menulis dengan memanggil Buka, dan mengatur offset item metadata saat ini dengan memanggil WriteNextItem sebelum memanggil WriteNextItemCommand.

Persyaratan

   
Target Platform Windows
Header spatialaudiometadata.h

Lihat juga

ISpatialAudioMetadataWriter