Share via

KSDATARANGE union

  • Article

The KSDATARANGE structure is a variable-length structure that describes a range of data formats.

Syntax

typedef union {
  struct {
    ULONG FormatSize;
    ULONG Flags;
    ULONG SampleSize;
    ULONG Reserved;
    GUID  MajorFormat;
    GUID  SubFormat;
    GUID  Specifier;
  };
  LONGLONG Alignment;
} KSDATAFORMAT, *PKSDATAFORMAT, KSDATARANGE, *PKSDATARANGE;

Members

  • FormatSize
    Specifies the size, in bytes, of this structure. This must be at least sizeof(KSDATARANGE), but can be larger for specific settings of MajorFormat, SubFormat, and Specifier. See the descriptions for these members for more information.

  • Flags
    Set Flags to KSDATARANGE_ATTRIBUTES (0x2) to indicate that the following KSDATARANGE is to be interpreted as an attribute list that uses the KSATTRIBUTE_LIST structure.

  • SampleSize
    This member is ignored.

  • Reserved
    Reserved. Drivers must set this member to zero.

  • MajorFormat
    Specifies either the specific major format of a data format that this data range matches, or KSDATAFORMAT_TYPE_WILDCARD if this data range matches all major formats. When MajorFormat has this value, both SubFormat and Specifier must also take on their wild card values. For more information about this member, see Remarks.

  • SubFormat
    Specifies either the specific subformat of a data format that this data range matches, or KSDATAFORMAT_SUBTYPE_WILDCARD if this data range matches all subformats. (In this instance, the specifier is not required to be its wild card value, unless MajorFormat is KSDATAFORMAT_TYPE_WILDCARD.) For more information about this member, see Remarks.

  • Specifier
    Specifies either the specifier of the data format that this data range matches, or KSDATAFORMAT_SPECIFIER_WILDCARD if this data range matches all specifier values. For more information about this member, see Remarks.

  • Alignment
    This member specifies the memory alignment in bytes for this buffer.

Remarks

Drivers use data ranges to describe the ranges of data formats they support.

For a list of MajorFormat, SubFormat, and Specifier GUIDs, see Stream Categories and its subtopics.

Requirements

Header

 Ks.h (include Ks.h)

See also

Stream Categories

 

 

Send comments about this topic to Microsoft