Edit

KSDATAFORMAT_WAVEFORMATEX structure (ksmedia.h)

  • Article

The KSDATAFORMAT_WAVEFORMATEX structure provides detailed information about the data format of an audio stream consisting of wave data.

Syntax

typedef struct {
  KSDATAFORMAT DataFormat;
  WAVEFORMATEX WaveFormatEx;
} KSDATAFORMAT_WAVEFORMATEX, *PKSDATAFORMAT_WAVEFORMATEX;

Members

DataFormat

Specifies the general features of the stream's data format. This member is a structure of type KSDATAFORMAT.

WaveFormatEx

Describes the wave-specific details of the audio stream's data format. This member contains an initialized WAVEFORMATEX structure.

Remarks

In response to an input DataRange parameter that specifies a WAVEFORMATEX format (see example in PCM Stream Data Range), the IMiniport::DataRangeIntersection method checks to see if the specified pin supports a compatible WAVEFORMATEX format. If so, the method outputs a KSDATAFORMAT_WAVEFORMATEX structure (see example in PCM Stream Data Format) to the buffer that its ResultantFormat parameter points to.

Note that the WaveFormatEx member of the KSDATAFORMAT_WAVEFORMATEX structure can be extended to include additional format information (for example, a channel configuration mask). For more information, see WAVEFORMATEXTENSIBLE.

Requirements

Requirement Value
Header ksmedia.h (include Ksmedia.h)

See also

IMiniport::DataRangeIntersection

KSDATAFORMAT

WAVEFORMATEX

WAVEFORMATEXTENSIBLE