Share via

Método ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects (spatialaudioclient.h)

  • Artículo

Coloca el sistema en el estado en el que se pueden enviar los datos del objeto de audio para su procesamiento y se puede modificar el estado ISpatialAudioObject .

Sintaxis

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

Parámetros

[out] availableDynamicObjectCount

Número de objetos de audio dinámicos que están disponibles para representarse para el paso de procesamiento actual. Todos los objetos de audio estáticos asignados se pueden representar en cada paso. Para obtener información sobre los tipos de objetos de audio, vea AudioObjectType.

[out] frameCountPerBuffer

Tamaño, en fotogramas de audio, del búfer devuelto por GetBuffer.

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
SPTLAUDCLNT_E_OUT_OF_ORDER
 Se llamó a BeginUpdatingAudioObjects dos veces sin una llamada coincidente a EndUpdatingAudioObjects entre las dos llamadas.
SPTLAUDCLNT_E_DESTROYED
 ISpatialAudioClient asociado a la secuencia de audio espacial se ha destruido.
AUDCLNT_E_DEVICE_INVALIDATED
 El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o dejado de estar disponible para su uso.
AUDCLNT_E_RESOURCES_INVALIDATED
 Un recurso asociado a la secuencia de audio espacial ya no es válido.
SPTLAUDCLNT_E_INTERNAL
 Se ha producido un error interno.
AUDCLNT_E_UNSUPPORTED_FORMAT
 El medio asociado a la secuencia de audio espacial usa un formato no admitido.

Comentarios

Se debe llamar a este método cada vez que se señala el evento pasado en SpatialAudioObjectRenderStreamActivationParams a ISpatialAudioClient::ActivateSpatialAudioStream ,
incluso si no hay datos de objeto de audio que enviar.

Para cada llamada BeginUpdatingAudioObjects , debe haber una llamada correspondiente a endUpdatingAudioObjects .
Si se llama a BeginUpdatingAudioObjects dos veces sin una llamada a EndUpdatingAudioObjects entre ellos, la segunda llamada a
BeginUpdatingAudioObjects devolverá SPTLAUDCLNT_E_OUT_OF_ORDER.

Requisitos

   
Plataforma de destino Windows
Encabezado spatialaudioclient.h

Consulte también

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase