Método IXAudio2Voice::GetEffectParameters (xaudio2.h)
Retorna os parâmetros específicos do efeito atual de um determinado efeito na cadeia de efeitos da voz.
Sintaxe
\\HRESULT GetEffectParameters(
[in] UINT32 EffectIndex,
[out] void *pParameters,
[out] UINT32 ParametersByteSize
);
Parâmetros
[in] EffectIndex
Índice baseado em zero de um efeito dentro da cadeia de efeitos da voz.
[out] pParameters
Retorna os valores atuais dos parâmetros específicos do efeito.
[out] ParametersByteSize
Tamanho, em bytes, da matriz pParameters.
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.
Falha com E_NOTIMPL se o efeito não der suporte a uma interface de controle de parâmetro genérica.
Comentários
GetEffectParameters sempre retorna os parâmetros atuais reais do efeito. No entanto, eles podem não corresponder aos parâmetros definidos pela chamada mais recente para IXAudio2Voice::SetEffectParameters: os parâmetros reais só serão alterados na próxima vez que o mecanismo de áudio for executado após a chamada IXAudio2Voice::SetEffectParameters (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetEffectParameters tiver sido 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 |