Share via

CS_DATARANGE_VIDEO (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure describes a range of video streams without bob or weave settings.

Syntax

typedef struct tagCS_DATARANGE_VIDEO {
  CSDATARANGE                 DataRange;
  BOOL                        bFixedSizeSamples;
  BOOL                        bTemporalCompression;
  DWORD                       StreamDescriptionFlags;
  DWORD                       MemoryAllocationFlags;
  CS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
  CS_VIDEOINFOHEADER          VideoInfoHeader;
} CS_DATARANGE_VIDEO, *PCS_DATARANGE_VIDEO;

Members

  • DataRange
    A CSDATARANGE structure specifying the major identifier for the format.
  • bFixedSizeSamples
    A BOOL value that specifies that all the samples are the same size if set to TRUE.
  • bTemporalCompression
    A BOOL value that 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
    A CS_VIDEO_STREAM_CONFIG_CAPS value that specifies the configuration of the stream, including scaling, cropping, and frame and data rates.
  • VideoInfoHeader
    A CS_VIDEOINFOHEADER structure that specifies the details of the video stream.

Remarks

The CS_DATARANGE_VIDEO structure is used for two related purposes:

  • At minidriver initialization time, the minidriver returns an array of CS_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 CS_DATARANGE_VIDEO unchanged. The minidriver then verifies the requested parameters and returns a CS_DATAFORMAT_VIDEO structure. The minidriver then calculates members that are unique to the particular format requested.
    For example, a stream that supports RGB16, RGB24, YVU9, and JPEG capture formats defines an array of four CS_DATAFORMAT_VIDEO structures.

Requirements

Header csmedia.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

Camera Driver Structures
CSDATARANGE
CS_VIDEO_STREAM_CONFIG_CAPS
CS_VIDEOINFOHEADER