Compartir a través de


Método IXAudio2VoiceCallback::OnBufferStart (xaudio2.h)

Se llama cuando la voz está a punto de empezar a procesar un nuevo búfer de audio.

Sintaxis

void OnBufferStart(
  void *pBufferContext
);

Parámetros

pBufferContext

Puntero de contexto asignado al miembro pContext de la estructura XAUDIO2_BUFFER cuando se envió el búfer.

Valor devuelto

None

Observaciones

pBufferContext es el puntero de contexto proporcionado originalmente por el miembro pContext de la estructura XAUDIO2_BUFFER , que puede ser NULL.

Se garantiza que se llama a OnBufferStart justo antes de que se consuma el primer byte del búfer actual. Es adecuado usar esta devolución de llamada para los cambios en el estado de voz, como los siguientes.

  • Envío de un nuevo búfer a la voz
  • Ajuste de los parámetros de volumen, tono y efecto de la voz
  • Habilitación o deshabilitación de un efecto en la cadena de efectos de la voz
Todas las acciones enumeradas anteriormente son sincrónicas cuando se realizan en una devolución de llamada XAudio2, por lo que los cambios surten efecto inmediatamente, lo que afecta al búfer que está a punto de iniciarse.

También es seguro usar esta devolución de llamada para escribir datos de audio en el búfer directamente, lo que puede ser útil para escenarios de streaming de baja latencia. Sin embargo, al igual que con todas las devoluciones de llamada XAudio2, no se debe realizar ningún trabajo que use una cantidad significativa de tiempo de procesador o podría bloquear la ejecución, incluidos los discos sincrónicos o las lecturas de red.

Para obtener información sobre los métodos de interfaz IXAudio2VoiceCallback , consulte la sección Devoluciones de llamada de XAudio2 .

Requisitos de la plataforma

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

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

Cómo: usar devoluciones de llamadas de voces de origen

IXAudio2VoiceCallback

Devoluciones de llamadas de XAudio2