Compartilhar via


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

Define os parâmetros de filtro em um dos envios dessa voz.

Sintaxe

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

Parâmetros

[in] pDestinationVoice

Ponteiro IXAudio2Voice para a voz de destino do envio cujos parâmetros de filtro serão definidos.

[in] pParameters

Ponteiro para uma estrutura XAUDIO2_FILTER_PARAMETERS que contém as informações de filtro.

[in] OperationSet

Identifica essa chamada como parte de um lote adiado. Consulte a Visão geral dos Conjuntos de Operações XAudio2 para obter mais informações.

Valor retornado

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de erro XAudio2 para obter descrições de códigos de erro.

Comentários

SetOutputFilterParameters falhará se o envio não tiver sido criado com o sinalizador XAUDIO2_SEND_USEFILTER. Esse método é utilizável somente em envios pertencentes a vozes de origem e submixagem e não tem efeito sobre os envios de uma voz de masterização.

ObservaçãoIXAudio2Voice::GetOutputFilterParameters sempre retorna os parâmetros de filtro atuais reais desse envio. No entanto, eles podem não corresponder aos parâmetros definidos pela chamada IXAudio2Voice::SetOutputFilterParameters mais recente: os parâmetros reais só serão alterados na próxima vez que o mecanismo de áudio for executado após a chamada IXAudio2Voice::SetOutputFilterParameters (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetOutputFilterParameters foi chamado com uma ID de operação adiada).
 

Requisitos de plataforma

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

Requisitos

   
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

IXAudio2Voice