Método IXAudio2Voice::GetEffectParameters (xaudio2.h)

  • Artículo

Devuelve los parámetros específicos del efecto actuales de un efecto determinado en la cadena de efectos de la voz.

Sintaxis

\\HRESULT GetEffectParameters(
  [in]  UINT32 EffectIndex,
  [out] void   *pParameters,
  [out] UINT32 ParametersByteSize
);

Parámetros

[in] EffectIndex

Índice de base cero de un efecto dentro de la cadena de efectos de la voz.

[out] pParameters

Devuelve los valores actuales de los parámetros específicos del efecto.

[out] ParametersByteSize

Tamaño, en bytes, de la matriz pParameters.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error. Consulte Códigos de error de XAudio2 para obtener descripciones de los códigos de error.

Se produce un error con E_NOTIMPL si el efecto no admite una interfaz de control de parámetros genérica.

Observaciones

GetEffectParameters siempre devuelve los parámetros actuales reales del efecto. Sin embargo, es posible que no coincidan con los parámetros establecidos por la llamada más reciente a IXAudio2Voice::SetEffectParameters: los parámetros reales solo se cambian la próxima vez que se ejecute el motor de audio después de la llamada IXAudio2Voice::SetEffectParameters (o después de la llamada IXAudio2::CommitChanges correspondiente, si se llamó a IXAudio2Voice::SetEffectParameters con un identificador de operación diferida).

Requisitos de la plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)

Requisitos

   
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

IXAPOParameters::GetParameters

IXAudio2Voice

Introducción a XAPO