KS_DATARANGE_VIDEO structure (ksmedia.h)
The KS_DATARANGE_VIDEO structure describes a range of video streams without bob or weave settings.
Syntax
typedef struct tagKS_DATARANGE_VIDEO {
KSDATARANGE DataRange;
BOOL bFixedSizeSamples;
BOOL bTemporalCompression;
DWORD StreamDescriptionFlags;
DWORD MemoryAllocationFlags;
KS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
KS_VIDEOINFOHEADER VideoInfoHeader;
} KS_DATARANGE_VIDEO, *PKS_DATARANGE_VIDEO;
Members
DataRange
Specifies the major identifier for the format.
bFixedSizeSamples
Specifies that all the samples are the same size if set to TRUE.
bTemporalCompression
Specifies whether each sample can stand independently on its own, without relying on previous or future samples.
StreamDescriptionFlags
Unused and should be set to zero.
MemoryAllocationFlags
Unused and should be set to zero.
ConfigCaps
Specifies the configuration of the stream, including scaling, cropping, and frame and data rates.
VideoInfoHeader
Specifies the details of the video stream.
Remarks
The KS_DATARANGE_VIDEO structure is used for two related purposes:
- At minidriver initialization time, the minidriver returns an array of KS_DATARANGE_VIDEO structures exposing all the supported formats for a given pin, including possible cropping and scaling options.
- When a particular format is selected by a user-mode client, the members (and their settings) of this structure determine whether a proposed format is supported by the minidriver. User-mode clients modify the contents of the VideoInfoHeader member but must leave all other members of KS_DATARANGE_VIDEO unchanged. The minidriver then verifies the requested parameters and returns a KS_DATAFORMAT_VIDEO structure. The minidriver then calculates members that are unique to the particular format requested.
Requirements
Requirement | Value |
---|---|
Header | ksmedia.h (include Ksmedia.h) |