Méthode ISpatialAudioMetadataItemsBuffer ::AttachToPopulatedBuffer (spatialaudiometadata.h)

Article
03/02/2024

Joint une mémoire tampon précédemment remplie pour le stockage des objets ISpatialAudioMetadataItems . Les éléments de métadonnées déjà présents dans la mémoire tampon sont conservés.

Syntaxe

HRESULT AttachToPopulatedBuffer(
  [in] BYTE   *buffer,
       UINT32 bufferLength
);

Paramètres

[in] buffer

Pointeur vers la mémoire à utiliser pour le stockage.

bufferLength

Longueur de la mémoire tampon fournie. Cette taille doit correspondre à la longueur requise pour le format de métadonnées et le nombre maximal d’éléments de métadonnées.

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 la copie avec un appel à Open ou l’objet a été fermé pour écriture avec un appel à Fermer.
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED	La mémoire tampon fournie a déjà été attachée.
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER	ISpatialAudioMetadataItems a été créé pour utiliser une mémoire tampon interne de pipeline multimédia, de sorte qu’une mémoire tampon externe ne peut pas être attachée.
SPTLAUD_MD_CLNT_E_FORMAT_MISMATCH	La mémoire tampon remplie fournie utilise un format différent du format actuel.
E_INVALIDARG	L’un des pointeurs fournis n’est pas valide. La mémoire tampon fournie n’est pas assez grande pour contenir le nombre maximal d’éléments de métadonnées. Appelez GetSpatialAudioMetadataItemsBufferLength pour déterminer la taille de mémoire tampon requise.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	spatialaudiometadata.h

Voir aussi

ISpatialAudioMetadataItemsBuffer

Partager via