Método ISpatialAudioObjectForHrtf::SetOrientation (spatialaudiohrtf.h)
Establece la orientación en el espacio 3D, en relación con el marco de referencia del agente de escucha, desde el que se representarán los datos de audio ISpatialAudioObjectForHrtf .
Sintaxis
HRESULT SetOrientation(
[in] const SpatialAudioHrtfOrientation *orientation
);
Parámetros
[in] orientation
Matriz de floats que define la matriz de rotación principal de fila 3x3.
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 |
|---|---|
|
No se llamó a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects antes de la llamada a SetOrientation. |
|
Se llamó a SetEndOfStream de forma explícita o implícita en un paso de procesamiento de audio anterior. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
Comentarios
Si nunca se llama a SetOrientation , se usa el valor predeterminado de una matriz de identidad. Después de llamar a SetOrientation , la orientación establecida se usará para el objeto de audio hasta que se cambie la orientación con otra llamada a SetOrientation.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | spatialaudiohrtf.h |