Método ISpatialAudioClient::GetMaxDynamicObjectCount (spatialaudioclient.h)

  • Artículo

Obtiene el número máximo de objetos de audio dinámicos para el cliente de audio espacial.

Sintaxis

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

Parámetros

[out] value

Obtiene el número máximo de objetos dinámicos para este cliente.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Comentarios

Un ISpatialAudioObject dinámico es uno que se activó estableciendo el parámetro de tipo en el método ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject en AudioObjectType_Dynamic. El cliente tiene un límite del número máximo de objetos de audio espacial dinámicos que se pueden activar a la vez. Cuando cambia la capacidad de la canalización de representación de audio, el sistema ajustará dinámicamente el número máximo de objetos de audio espacial dinámico simultáneos. Antes de hacerlo, el sistema llamará a OnAvailableDynamicObjectCountChange para notificar a los clientes el cambio de límite de recursos.

Llame a Release en un ISpatialAudioObject cuando ya no se use para liberar el recurso para crear nuevos objetos de audio espacial dinámicos.

Cuando Windows Sonic no está disponible (por ejemplo, al reproducir en altavoces estéreo portátiles incrustados o si el usuario no ha habilitado Explícitamente Windows Sonic en el dispositivo), el número de objetos dinámicos disponibles devueltos por GetMaxDynamicObjectCount a una aplicación será 0.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado spatialaudioclient.h

Consulte también

ISpatialAudioClient