KSDATARANGE union
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