estrutura XAUDIO2_VOICE_SENDS (xaudio2.h)

Artigo
08/28/2023

Define um conjunto de vozes para receber dados de uma única voz de saída.

Sintaxe

typedef struct XAUDIO2_VOICE_SENDS {
  UINT32                  SendCount;
  XAUDIO2_SEND_DESCRIPTOR *pSends;
} XAUDIO2_VOICE_SENDS;

Membros

SendCount

Número de vozes para receber a saída da voz. Um valor OutputCount de 0 indica que a voz não deve enviar saída para nenhuma voz.

pSends

Matriz de estruturas XAUDIO2_SEND_DESCRIPTOR que descrevem as vozes de destino e os filtros que devem ser usados ao enviar para as vozes. Essa matriz deve conter elementos SendCount . Se SendCount for 0 pSends , deverá ser NULL. Observe que os pSends não podem conter a mesma voz mais de uma vez.

Comentários

Se pSends não for NULL, todos os seus elementos deverão ser não NULL. Para enviar a saída para a chamada de voz de masterização padrão IXAudio2Voice::SetOutputVoices com o argumento pSendList definido como NULL.

Definir SendCount como 0 é útil para determinados efeitos, como medidores de volume ou gravadores de arquivos que não geram nenhuma saída de áudio para passar para outra voz.

Se necessário, uma voz executará uma conversão de taxa de amostragem única, da taxa de amostragem de entrada da voz para a taxa de amostragem de entrada das vozes de saída da voz. Como apenas uma conversão de taxa de amostragem será executada, todas as vozes de saída da voz devem ter a mesma taxa de amostragem de entrada. Se as taxas de amostra de entrada da voz e suas vozes de saída forem as mesmas, nenhuma conversão de taxa de amostragem será executada.