Condividi tramite


Metodo IXAudio2VoiceCallback::OnBufferStart (xaudio2.h)

Chiamato quando la voce sta per avviare l'elaborazione di un nuovo buffer audio.

Sintassi

void OnBufferStart(
  void *pBufferContext
);

Parametri

pBufferContext

Puntatore di contesto assegnato al membro pContext della struttura XAUDIO2_BUFFER quando è stato inviato il buffer.

Valore restituito

nessuno

Osservazioni

pBufferContext è il puntatore di contesto originariamente fornito dal membro pContext della struttura XAUDIO2_BUFFER , che può essere NULL.

OnBufferStart viene chiamato immediatamente prima che venga utilizzato il primo byte del buffer corrente. È opportuno usare questo callback per le modifiche apportate allo stato della voce, ad esempio quanto segue.

  • Invio di un nuovo buffer alla voce
  • Regolazione dei parametri del volume, dell'inclinazione e dell'effetto della voce
  • Abilitazione o disabilitazione di un effetto nella catena di effetti della voce
Tutte le azioni elencate in precedenza sono sincrone quando vengono eseguite in un callback di XAudio2, quindi le modifiche avranno effetto immediatamente, influenzando il buffer che sta per iniziare.

È anche possibile usare questo callback per scrivere direttamente dati audio nel buffer, che può essere utile per gli scenari di streaming a bassa latenza. Tuttavia, come per tutti i callback di XAudio2, non è necessario eseguire alcuna operazione che usi una quantità significativa di tempo del processore o potrebbe bloccare l'esecuzione, inclusi i dischi sincroni o le letture di rete.

Per informazioni sui metodi di interfaccia IXAudio2VoiceCallback , vedere la sezione Callback XAudio2 .

Requisiti della piattaforma

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

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione xaudio2.h

Vedi anche

Procedura: Usare callback di voci di origine

IXAudio2VoiceCallback

Callback di XAudio2