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

  • Artículo

Asocia la memoria proporcionada por el autor de la llamada para almacenar objetos ISpatialAudioMetadataItems .

Sintaxis

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

Parámetros

[in] buffer

Puntero a la memoria que se va a usar para el almacenamiento.

bufferLength

Longitud del búfer proporcionado. Este tamaño debe coincidir con la longitud necesaria para el formato de metadatos y el número máximo de elementos de metadatos.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems no se ha abierto para copiar con una llamada a Open o el objeto se ha cerrado para escribir con una llamada a Close.
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER
 ISpatialAudioMetadataItems se creó para usar un búfer interno de canalización multimedia, por lo que no se puede adjuntar un búfer externo.
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED
 El búfer proporcionado ya se ha adjuntado.
E_INVALIDARG
 Uno de los punteros proporcionados no es válido.

El búfer proporcionado no es lo suficientemente grande como para contener el número máximo de elementos de metadatos.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataItemsBuffer