Metodo IXAudio2SourceVoice::SetSourceSampleRate (xaudio2.h)

Riconfigura la voce per usare i dati di origine a una frequenza di esempio diversa rispetto alla frequenza specificata al momento della creazione della voce.

Sintassi

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Parametri

[in] NewSourceSampleRate

La nuova frequenza di esempio della voce deve elaborare i dati inviati all'indirizzo. Le tariffe di esempio valide sono da 1kHz a 200kHz.

Valore restituito

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

Commenti

Il metodo SetSourceSampleRate supporta il riutilizzo delle voci XAudio2 consentendo a una voce di riprodurre suoni con una varietà di frequenze di esempio. Per usare SetSourceSampleRate la voce deve essere stata creata senza i flag XAUDIO2_VOICE_NOPITCH o XAUDIO2_VOICE_NOSRC e non deve avere buffer attualmente accodati.

L'uso tipico di SetSourceSampleRate consiste nel supportare il pool vocale. Ad esempio, per supportare il pool vocale di un'applicazione, è necessario precreare tutte le voci che si prevede di usare. Ogni volta che viene riprodotto un nuovo suono, l'applicazione sceglie una voce inattiva o , se tutte le voci sono occupato, seleziona la voce meno importante e chiama SetSourceSampleRate sulla voce con la frequenza di campionamento del nuovo suono. Dopo aver chiamato SetSourceSampleRate sulla voce, l'applicazione può iniziare immediatamente a inviare e riprodurre buffer con la nuova frequenza di esempio. Ciò consente all'applicazione di evitare il sovraccarico della creazione e dell'eliminazione delle voci spesso durante il gioco.

Requisiti della piattaforma

Requisiti

Vedi anche

IXAudio2SourceVoice