XAUDIO2_VOICE_SENDS-Struktur (xaudio2.h)

Artikel
08/28/2023

Definiert einen Satz von Stimmen, um Daten von einer einzelnen Ausgabestimme zu empfangen.

Syntax

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

Member

SendCount

Anzahl der Stimmen, die die Ausgabe der Stimme empfangen sollen. Ein OutputCount-Wert von 0 gibt an, dass die Stimme keine Ausgabe an Stimmen senden sollte.

pSends

Array von XAUDIO2_SEND_DESCRIPTOR Strukturen, die Zielstimmdaten und die Filter beschreiben, die beim Senden an die Stimmen verwendet werden sollen. Dieses Array sollte SendCount-Elemente enthalten. Wenn SendCount 0 pSends ist, sollte NULL sein. Beachten Sie, dass pSends nicht mehr als einmal dieselbe Stimme enthalten können.

Hinweise

Wenn pSends nicht NULL ist, müssen alle Elemente nicht NULL sein. So senden Sie die Ausgabe an den Standardmäßigen Mastering-Sprachanruf IXAudio2Voice::SetOutputVoices , wobei das pSendList-Argument auf NULL festgelegt ist.

Das Festlegen von SendCount auf 0 ist nützlich für bestimmte Effekte, z. B. Lautstärkemesser oder Dateischreiber, die keine Audioausgabe generieren, die an eine andere Stimme übergeben wird.

Bei Bedarf führt eine Stimme eine einzelne Abtastratekonvertierung durch, von der Eingabe-Samplerate der Stimme bis zur Eingabe-Abtastrate der Ausgabestimme der Stimme. Da nur eine Konvertierung der Abtastrate durchgeführt wird, müssen alle Ausgabestimme der Stimme die gleiche Eingabe-Abtastrate aufweisen. Wenn die Eingabe-Sampleraten der Stimme und ihrer Ausgabestimme identisch sind, wird keine Konvertierung der Abtastrate durchgeführt.