DVD_VideoAttributes structure (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The DVD_VideoAttributes structure describes the attributes of the video stream for the current title or menu.

Syntax

typedef struct tagDVD_VideoAttributes {
  BOOL                  fPanscanPermitted;
  BOOL                  fLetterboxPermitted;
  ULONG                 ulAspectX;
  ULONG                 ulAspectY;
  ULONG                 ulFrameRate;
  ULONG                 ulFrameHeight;
  DVD_VIDEO_COMPRESSION Compression;
  BOOL                  fLine21Field1InGOP;
  BOOL                  fLine21Field2InGOP;
  ULONG                 ulSourceResolutionX;
  ULONG                 ulSourceResolutionY;
  BOOL                  fIsSourceLetterboxed;
  BOOL                  fIsFilmMode;
} DVD_VideoAttributes;

Members

fPanscanPermitted

TRUE means the picture can be shown as pan-scan if the display aspect ratio is 4 x 3.

fLetterboxPermitted

TRUE means the picture can be shown as letterbox if the display aspect ratio is 4 x 3.

ulAspectX

The video stream's X aspect (4 or 16).

ulAspectY

The video stream's Y aspect (3 or 9).

ulFrameRate

The frame rate in hertz (Hz), either 50 or 60.

ulFrameHeight

The frame height in lines (525 for a frame rate of 60 Hz or 625 for 50 Hz).

Compression

Variable of type DVD_VIDEO_COMPRESSION indicating the MPEG compression type used on the disc.

fLine21Field1InGOP

TRUE means there is user data in line 21, field 1.

fLine21Field2InGOP

TRUE means there is user data in line 21, field 2.

ulSourceResolutionX

The x-axis source resolution (352, 704, or 720).

ulSourceResolutionY

The y-axis source resolution (240, 480, 288, or 576).

fIsSourceLetterboxed

TRUE means the source video is in letterbox format. Subpictures and menu buttons can only be displayed in the active video area.

fIsFilmMode

For 625/50 Hz systems, TRUE means "film mode" and FALSE means "camera mode."

Remarks

This structure is filled when an application calls the IDvdInfo2::GetCurrentVideoAttributes method.

Requirements

See also

DirectShow Structures