Método ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)
Activa un ISpatialAudioObjectForHrtf para la representación de audio.
Sintaxis
HRESULT ActivateSpatialAudioObjectForHrtf(
[in] AudioObjectType type,
[out] ISpatialAudioObjectForHrtf **audioObject
);
Parámetros
[in] type
Tipo de objeto de audio que se va a activar. Para los objetos de audio dinámicos, este valor debe ser AudioObjectType_Dynamic. Para los objetos de audio estáticos, especifique uno de los valores del canal de audio estático de la enumeración. Especificar AudioObjectType_None generará un objeto de audio que no está espacializado.
[out] audioObject
Recibe un puntero a la interfaz activada.
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 |
|---|---|
|
El sistema ha alcanzado el número máximo de objetos de audio simultáneos. |
|
ISpatialAudioClient asociado a la secuencia de audio espacial se ha destruido. |
|
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 no están disponibles para su uso. |
|
Se ha producido un error interno. |
|
El medio asociado a la secuencia de audio espacial usa un formato no admitido. |
Comentarios
Un ISpatialAudioObjectForHrtf dinámico es uno que se activó estableciendo el parámetro type en el método ActivateSpatialAudioObjectForHrtf 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. Una vez alcanzado el límite, si se intenta activar objetos de audio adicionales, este método devolverá un error de SPTLAUDCLNT_E_NO_MORE_OBJECTS. Para evitar esto, llame a Release en cada ISpatialAudioObjectForHrtf dinámico después de que ya no se use para liberar el recurso para que se pueda reasignar. Vea ISpatialAudioObjectgBase::IsActive e ISpatialAudioObjectgBase::SetEndOfStream para obtener más información sobre la administración de la duración de los objetos de audio espacial.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | spatialaudiohrtf.h |