Edit

KSDATARANGE_AUDIO structure (ksmedia.h)

  • Article

The KSDATARANGE_AUDIO structure specifies a range of audio formats.

Syntax

typedef struct {
  KSDATARANGE DataRange;
  ULONG       MaximumChannels;
  ULONG       MinimumBitsPerSample;
  ULONG       MaximumBitsPerSample;
  ULONG       MinimumSampleFrequency;
  ULONG       MaximumSampleFrequency;
} KSDATARANGE_AUDIO, *PKSDATARANGE_AUDIO;

Members

DataRange

Specifies the MajorFormat and SubFormat GUIDs as well as the Specifier GUID for the audio data. This member is an initialized KSDATARANGE structure.

MaximumChannels

Specifies the maximum number of channels supported. A value of (ULONG)-1 for this member means that the number of channels has no explicit limit, although the number of channels might be practically limited by the availability of resources such as memory or processing power.

MinimumBitsPerSample

Specifies the minimum bits per sample supported.

MaximumBitsPerSample

Specifies the maximum bits per sample supported.

MinimumSampleFrequency

Specifies the minimum frequency allowed.

MaximumSampleFrequency

Specifies the maximum frequency allowed.

Remarks

For examples of data ranges that use the KSDATARANGE_AUDIO structure, see PCM Stream Data Range, DirectSound Stream Data Range, and Specifying AC-3 Data Ranges.

For information about data ranges and intersection handling, see Data-Intersection Handlers.

Requirements

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

See also

KSDATARANGE