Audiodatenformate

Um das Datenformat für einen Wellenaudiodatenstrom anzugeben, folgt auf die KSDATAFORMAT-Struktur sofort eine WAVEFORMATEX - oder KSDSOUND_BUFFERDESC-Struktur , und der Specifier-Member von KSDATAFORMAT ist entsprechend auf einen der folgenden beiden Werte festgelegt:

• KSDATAFORMAT_SPECIFIER_WAVEFORMATEX

  Gibt an, dass das Datenformat zu einem Wellendatenstrom gehört, der von einer waveIn- oder waveOut-Anwendung verwendet wird. Wenn formatSize der KSDATAFORMAT-Struktur groß genug ist, ist der Datenformatbezeichner, der der KSDATAFORMAT-Struktur folgt, eine WAVEFORMATEX-Struktur.

• KSDATAFORMAT_SPECIFIER_DSOUND

  Gibt an, dass das Datenformat zu einem Wellendatenstrom gehört, der von einer DirectSound-Anwendung verwendet wird. In diesem Fall ist der Datenformatbezeichner, der der KSDATAFORMAT-Struktur folgt, eine KSDSOUND_BUFFERDESC-Struktur, die eine eingebettete WAVEFORMATEX-Struktur enthält.

Die KSDATAFORMAT_WAVEFORMATEX-Struktur kapselt sowohl eine KSDATAFORMAT-Struktur als auch die darauf folgende WAVEFORMATEX-Struktur. Ebenso kapselt die KSDATAFORMAT_DSOUND-Struktur sowohl eine KSDATAFORMAT-Struktur als auch die darauf folgende DSOUND_BUFFERDESC-Struktur.

Für KSDATAFORMAT_WAVEFORMATEX oder KSDATAFORMAT_DSOUND ist das letzte Element in der Struktur eine eingebettete WAVEFORMATEX-Struktur; bei KSDATAFORMAT_DSOUND ist die WAVEFORMATEX-Struktur in der eingebetteten DSOUND_BUFFERDESC-Struktur enthalten. In beiden Fällen kann die WAVEFORMATEX-Struktur der Anfang einer WAVEFORMATEXTENSIBLE-Struktur sein. In diesem Fall wird der wFormatTag-Member von WAVEFORMATEX auf den Wert WAVE_FORMAT_EXTENSIBLE festgelegt. Weitere Informationen finden Sie unter Erweiterbare Wave-Format Deskriptoren.

Um das Datenformat für einen MIDI- oder DirectMusic-Stream anzugeben, reicht die KSDATAFORMAT-Struktur aus. es folgen keine zusätzlichen Informationen.

Beispiele für Wave- und DirectSound-Datenformate finden Sie unter PCM Stream Data Format und DirectSound Stream Data Format. Beispiele für MIDI- und DirectMusic-Datenformate finden Sie unter MIDI Stream Data Format und DirectMusic Stream Data Format.