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
È 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 |