Méthode ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems (spatialaudiometadata.h)

Article
08/26/2023

Crée un objet ISpatialAudioMetadataItems pour stocker des éléments de métadonnées audio spatiales.

Syntaxe

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

Paramètres

[in] maxItemCount

Nombre maximal d’éléments de métadonnées pouvant être stockés dans les ISpatialAudioMetadataItems retournés.

[in] frameCount

Plage valide de positions de décalage de trame pour les éléments de métadonnées stockés dans les ISpatialAudioMetadataItems retournés.

[out, optional] metadataItemsBuffer

Si un pointeur est fourni, retourne une interface ISpatialAudioMetadataItemsBuffer qui fournit des méthodes pour attacher la mémoire fournie par l’appelant pour le stockage des éléments de métadonnées. Si ce paramètre a la valeur NULL, l’objet alloue un stockage interne pour les éléments. Cette interface ne peut pas être obtenue via QueryInterface.

[out] metadataItems

Reçoit un objet ISpatialAudioMetadataItems instance qui peut être rempli avec des éléments de métadonnées à l’aide d’un ISpatialAudioMetadataWriter ou DSpatialAudioMetadataCopier et peut être lu avec un ISpatialAudioMetadataReader.

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
E_INVALIDARG	Le pointeur fourni dans le paramètre metadataItems n’est pas valide. La valeur de maxItemCount ou frameCount est 0.

Configuration requise


Plateforme cible	Windows
En-tête	spatialaudiometadata.h

Voir aussi

ISpatialAudioMetadataClient

Partager via