Partager via


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

Joint la mémoire fournie par l’appelant pour le stockage des objets ISpatialAudioMetadataItems .

Syntaxe

HRESULT AttachToBuffer(
  [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_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_BUFFER_ALREADY_ATTACHED
La mémoire tampon fournie a déjà été attachée.
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.

Configuration requise

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

Voir aussi

ISpatialAudioMetadataItemsBuffer