## Overview of DVD Interfaces and Data Types

This article provides an overview of the DVD interfaces and data types used in Microsoft® DirectShow™.

Contents of this article:

- DVD Application-Level Interfaces
- DVD Decoder Filter Interfaces
- DVD Filter Graph Media Types, Formats, and Events

DVD Application-Level Interfaces

The following list shows DVD interfaces that media developers can use to create applications.

IAMLine21Decoder
  Provides access to closed captioning information and settings. Closed captioning information is transmitted in the vertical blanking interval (VBI) of television signals, specifically on line 21 (Line21) of field 1 in the VBI.
IDvdControl
  Controls the playback and search mechanisms of a DVD-Video disc that contains one or more video movies.
IDvdGraphBuilder
  Enables the DVD application writer to easily build a filter graph for DVD-Video playback.
IDvdInfo
  Enables an application to query for attributes of available DVD-Video titles and the DVD player status. This interface also allows for control of a DVD player beyond Annex J in the DVD specification.
IMixerPinConfig
  Exposed on the input pins of overlay mixer filters and contains methods that manipulate video streams in various ways. The overlay mixer filter contains multiple input pins that are dynamically created as video input streams are added.

DVD Decoder Filter Interfaces

The following list shows DVD interfaces that developers can use to set and retrieve device and sample properties.

IKsPropertySet
  Enables you to set and retrieve device properties. Use this interface to set and retrieve any of the properties from the following list.
  - DVD Copy Protection Property Set — These properties provide authentication of copy protection information from hardware or software decrypters.
  - DVD Subpicture Property Set — These properties control the color, contrast, and output of the subpicture display.
  - DVD Time Stamp Rate Change Property Set — These properties enable you to change DVD playback rate, by modifying timestamps between input and output pins on two filters.
IMediaSample2
  Enables you to set and to retrieve sample properties. This interface is derived from the IMediaSample interface and uses the following data types:
  - AM_MEDIA_TYPE structure — Describes a media sample type. This structure can include the following substructures.
    - VIDEOINFOHEADER2 structure — Describes the bitmap and color information for a video image, including interlace, copy protection, and pixel aspect ratio information.
    - MPEG2VIDEOINFO structure — Describes an MPEG-2 video stream.
  - AM_SAMPLE_PROPERTY_FLAGS enumerated type — Indicates values for the dwSampleFlags member of the AM_SAMPLE2_PROPERTIES structure.
  - AM_SAMPLE2_PROPERTIES structure — Generic media sample properties structure.
IVPConfig
  Enables a video port (VP) mixer filter to communicate with a VP driver (decoder), to set and retrieve configuration information. This interface assumes that the mixer filter creates the video port.
IVPNotify
  Enables you to control the properties of a filter that uses a video port. This interface derives from the IVPBaseNotify interface.

DVD Filter Graph Media Types, Formats, and Events

The following articles provide more information about DVD:

- DirectShow DVD Support — Provides a diagram of a DVD filter graph and outlines the media types and data formats used in each connection.
- DVD Event Notification Codes — Describes DirectShow system-defined events, which filters in the filter graph pass to the filter graph manager. Filters pass these events to the filter graph manager by using the IMediaEventSink::Notify method, and the application retrieves them with the IMediaEvent::GetEvent method.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.