Audiodatenformate

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

• KSDATAFORMAT_SPECIFIER_WAVEFORMATEX

  Gibt an, dass das Datenformat zu einem Wellenstrom gehört, der von einer WaveIn- oder WaveOut-Anwendung verwendet wird. Wenn in diesem Fall die FormatSize-Struktur der KSDATAFORMAT-Struktur groß genug ist, ist der Datenformatbezeichner nach der KSDATAFORMAT-Struktur 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 nach der KSDATAFORMAT-Struktur 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 das wFormatTag-Element von WAVEFORMATEX auf den Wert WAVE_FORMAT_EXTENSIBLE festgelegt. Weitere Informationen finden Sie unter Extensible Wave-Format Deskriptors.

Um das Datenformat für einen MIDI- oder DirectMusic-Stream anzugeben, ist die KSDATAFORMAT-Struktur ausreichend; es folgen keine weiteren Informationen.

Beispiele für Wellen- 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.