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

Artículo
08/26/2023

Crea un objeto ISpatialAudioMetadataItems para almacenar elementos de metadatos de audio espaciales.

Sintaxis

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

Parámetros

[in] maxItemCount

Número máximo de elementos de metadatos que se pueden almacenar en los ISpatialAudioMetadataItems devueltos.

[in] frameCount

Intervalo válido de posiciones de desplazamiento de fotogramas para los elementos de metadatos almacenados en los ISpatialAudioMetadataItems devueltos.

[out, optional] metadataItemsBuffer

Si se proporciona un puntero, devuelve una interfaz ISpatialAudioMetadataItemsBuffer que proporciona métodos para adjuntar memoria proporcionada por el autor de la llamada para el almacenamiento de elementos de metadatos. Si este parámetro es NULL, el objeto asignará almacenamiento interno para los elementos. Esta interfaz no se puede obtener a través de QueryInterface.

[out] metadataItems

Recibe un objeto ISpatialAudioMetadataItems de instancia que se puede rellenar con elementos de metadatos mediante ISpatialAudioMetadataWriter o ISpatialAudioMetadataCopier y se puede leer con un ISpatialAudioMetadataReader.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_INVALIDARG	El puntero proporcionado en el parámetro metadataItems no es válido. El valor de maxItemCount o frameCount es 0.

Requisitos


Plataforma de destino	Windows
Encabezado	spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataClient