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

  • Artículo

Asocia un búfer rellenado previamente para el almacenamiento de objetos ISpatialAudioMetadataItems . Los elementos de metadatos que ya están en el búfer se conservan.

Sintaxis

HRESULT AttachToPopulatedBuffer(
  [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_BUFFER_ALREADY_ATTACHED
 El búfer proporcionado ya se ha adjuntado.
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_FORMAT_MISMATCH
 El búfer rellenado proporcionado usa un formato diferente del formato actual.
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. Llame a GetSpatialAudioMetadataItemsBufferLength para determinar el tamaño de búfer necesario.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataItemsBuffer