Compartilhar via

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

  • Artigo

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

Confira também

IXAPOParameters::GetParameters

IXAudio2Voice

Visão geral do XAPO