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

Establece los parámetros de filtro en uno de los envíos de voz.

Sintaxis

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

Parámetros

[in] pDestinationVoice

PUNTERO IXAudio2Voice a la voz de destino del envío cuyos parámetros de filtro se establecerán.

[in] pParameters

Puntero a una estructura de XAUDIO2_FILTER_PARAMETERS que contiene la información del filtro.

[in] OperationSet

Identifica esta llamada como parte de un lote diferido. Consulte la introducción a los conjuntos de operaciones XAudio2 para obtener más información.

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.

Observaciones

SetOutputFilterParameters producirá un error si el envío no se creó con la marca XAUDIO2_SEND_USEFILTER. Este método solo se puede usar en los envíos que pertenecen a las voces de origen y submezcla y no tiene ningún efecto en los envíos de voz de maestro.

NotaIXAudio2Voice::GetOutputFilterParameters siempre devuelve los parámetros de filtro actuales reales de este envío. Sin embargo, es posible que no coincidan con los parámetros establecidos por la llamada a IXAudio2Voice::SetOutputFilterParameters : los parámetros reales solo se cambian la próxima vez que se ejecute el motor de audio después de la llamada IXAudio2Voice::SetOutputFilterParameters (o después de la llamada IXAudio2::CommitChanges , si IXAudio2Voice::SetOutputFilterParameters se llamó con un identificador de operación diferido).

 

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

IXAudio2Voice