Partager via

IXAudio2VoiceCallback ::OnBufferStart, méthode (xaudio2.h)

  • Article

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
Toutes les actions répertoriées ci-dessus sont synchrones lorsqu’elles sont effectuées dans un rappel XAudio2, de sorte que les modifications prennent effet immédiatement, affectant la mémoire tampon sur le point de démarrer.

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

Voir aussi

Procédure : utiliser des rappels de voix source

IXAudio2VoiceCallback

Rappels XAudio2