Método IXAudio2Voice::SetFilterParameters (xaudio2.h)
Define os parâmetros de filtro da voz.
Sintaxe
\\HRESULT SetFilterParameters(
[in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
[in] UINT32 OperationSet
);
Parâmetros
[in] pParameters
Ponteiro para uma estrutura XAUDIO2_FILTER_PARAMETERS que contém as informações do 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.
Retornar valor
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
SetFilterParameters falhará se a voz não tiver sido criada com o sinalizador XAUDIO2_VOICE_USEFILTER.
Esse método é utilizável somente em vozes de origem e submixagem e não tem efeito sobre o domínio de vozes.
ObservaçãoIXAudio2Voice::GetFilterParameters sempre retorna os parâmetros de filtro atuais reais dessa voz. No entanto, eles podem não corresponder aos parâmetros definidos pela chamada IXAudio2Voice::SetFilterParameters 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::SetFilterParameters (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetFilterParameters tiver sido chamado com uma ID de operação adiada).
Requisitos da plataforma
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | xaudio2.h |