Méthode ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

Article
08/26/2023

Écrit des commandes de métadonnées et des données de valeur dans l’élément actif.

Syntaxe

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

Paramètres

[in] commandID

Commande prise en charge par le format de métadonnées de l’objet. L’appel échoue si la commande n’est pas définie par le format de métadonnées. Chaque commande ne peut être écrite qu’une seule fois par élément.

[in] valueBuffer

Pointeur vers une mémoire tampon qui stocke des données spécifiques à la commande, comme spécifié par la définition de format de métadonnées.

[in] valueBufferLength

Taille, en octets, des données de commande fournies dans le paramètre valueBuffer . La taille doit correspondre à la définition de commande spécifiée par le format de métadonnées, sinon l’appel échoue.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems n’a pas été ouvert pour l’écriture avec un appel à Open ou l’objet a été fermé pour écriture avec un appel à Fermer.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN	WriteNextItem n’a pas été appelé après l’appel d’Open et avant l’appel à WriteNextItemCommand.

Remarques

Vous devez ouvrir ISpatialAudioMetadataWriter pour l’écriture en appelant Open, puis définir le décalage de l’élément de métadonnées actuel en appelant WriteNextItem avant d’appeler WriteNextItemCommand.

Configuration requise


Plateforme cible	Windows
En-tête	spatialaudiometadata.h

Voir aussi

ISpatialAudioMetadataWriter

Partager via