Metodo IXAudio2Voice::SetOutputFilterParameters (xaudio2.h)

Articolo
03/08/2023

Imposta i parametri del filtro su uno degli invii di questa voce.

Sintassi

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

Parametri

[in] pDestinationVoice

Puntatore IXAudio2Voice alla voce di destinazione dell'invio i cui parametri di filtro verranno impostati.

[in] pParameters

Puntatore a una struttura XAUDIO2_FILTER_PARAMETERS contenente le informazioni sul filtro.

[in] OperationSet

Identifica questa chiamata come parte di un batch posticipato. Per altre informazioni, vedere panoramica dei set di operazioni XAudio2 .

Valore restituito

Restituisce S_OK in caso di esito positivo, in caso contrario, un codice di errore. Per le descrizioni dei codici di errore, vedere Codici di errore XAudio2 .

Commenti

SetOutputFilterParameters avrà esito negativo se l'invio non è stato creato con il flag XAUDIO2_SEND_USEFILTER. Questo metodo è utilizzabile solo per gli invii appartenenti alle voci di origine e submix e non ha alcun effetto sugli invii di una voce mastering.

NotaIXAudio2Voice::GetOutputFilterParameters restituisce sempre i parametri di filtro correnti effettivi di questo invio. Tuttavia, questi parametri potrebbero non corrispondere ai parametri impostati dalla chiamata IXAudio2Voice::SetOutputFilterParameters : i parametri effettivi vengono modificati solo alla successiva esecuzione del motore audio dopo la chiamata IXAudio2Voice::SetOutputFilterParameters (o dopo la chiamata IXAudio2::CommitChanges corrispondente, se IXAudio2Voice::SetOutputFilterParameters è stato chiamato con un ID operazione posticipato).

Requisiti della piattaforma

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

Requisiti


Piattaforma di destinazione	Windows
Intestazione	xaudio2.h

Vedi anche

IXAudio2Voice

Condividi tramite