IXAudio2VoiceCallback ::OnBufferStart, méthode (xaudio2.h)
Appelé lorsque la voix est sur le point de commencer à traiter une nouvelle mémoire tampon audio.
Syntaxe
void OnBufferStart(
void *pBufferContext
);
Paramètres
pBufferContext
Pointeur de contexte affecté au membre pContext de la structure XAUDIO2_BUFFER lors de l’envoi de la mémoire tampon.
Valeur de retour
None
Remarques
pBufferContext est le pointeur de contexte fourni à l’origine par le membre pContext de la structure XAUDIO2_BUFFER , qui peut être NULL.
OnBufferStart est assuré d’être appelé juste avant la consommation du premier octet de la mémoire tampon actuelle. Il est approprié d’utiliser ce rappel pour les modifications apportées à l’état de la voix, comme suit.
- Envoi d’une nouvelle mémoire tampon à la voix
- Ajustement des paramètres de volume, de hauteur et d’effet de la voix
- Activation ou désactivation d’un effet dans la chaîne d’effets de la voix
Il est également possible d’utiliser ce rappel pour écrire directement des données audio dans la mémoire tampon, ce qui peut être utile pour les scénarios de diffusion en continu à faible latence. Toutefois, comme pour tous les rappels XAudio2, aucun travail ne doit être effectué qui utilise une quantité importante de temps processeur ou peut bloquer l’exécution, y compris les lectures de disque synchrone ou de réseau.
Pour plus d’informations sur les méthodes d’interface IXAudio2VoiceCallback , consultez la section Rappels XAudio2 .
Configuration requise pour la plateforme
Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | xaudio2.h |