AM_DVD_GRAPH_FLAGS Enumeration

  • Article
 
Microsoft DirectShow 9.0

AM_DVD_GRAPH_FLAGS Enumeration

The AM_DVD_GRAPH_FLAGS enumeration specifies how the DVD Navigator builds a DVD playback graph. These flags are used with the IDvdGraphBuilder::RenderDvdVideoVolume method.

Syntax

  enum {
    AM_DVD_HWDEC_PREFER =   0x01,
    AM_DVD_HWDEC_ONLY   =   0x02,
    AM_DVD_SWDEC_PREFER =   0x04,
    AM_DVD_SWDEC_ONLY   =   0x08,
    AM_DVD_NOVPE        =  0x100,
    AM_DVD_DO_NOT_CLEAR =  0x200,
    AM_DVD_VMR9_ONLY    =  0x800,
    AM_DVD_EVR_ONLY     = 0x1000
} AM_DVD_GRAPH_FLAGS;

Members

AM_DVD_HWDEC_PREFER

Use a hardware decoder if possible. If none is available, use a software decoder. This is the default setting. Hardware DVD decoders are registered under the CLSID_DVDHWDecodersCategory filter category. See Filter Categories.

AM_DVD_HWDEC_ONLY

Use a hardware decoder; do not use a software decoder. Do not combine this flag with the AM_DVD_VMR9_ONLY or AM_DVD_EVR_ONLY flag.

AM_DVD_SWDEC_PREFER

Use a software decoder if possible. If none is available, use a hardware decoder.

AM_DVD_SWDEC_ONLY

Use a software decoder; do not use a hardware decoder.

AM_DVD_NOVPE

Do not show video on the computer monitor. Use of this flag should be limited only to the combination of a hardware DVD-Video decoder and a display device with a port that can connect to a TV. A set-top box type of device that can play back DVD-Video could play DVD titles to be viewed on a TV set rather than a computer monitor.

AM_DVD_DO_NOT_CLEAR

Do not clear the filter graph before building the DVD playback graph. By default, the RenderDvdVideoVolume method removes any existing filters from the graph before it builds the DVD playback graph. Applies to Windows Vista and later.

AM_DVD_VMR9_ONLY

Use the Video Mixing Renderer Filter 9 (VMR-9) for rendering; fail if the VMR-9 is not available. Do not combine this flag with the AM_DVD_EVR_ONLY flag.

AM_DVD_EVR_ONLY

Use the Enhanced Video Renderer (EVR) for rendering; fail if the EVR is not available. Applies to Windows Vista and later.

Remarks

Do not combine more than one of the following flags:

  • AM_DVD_HWDEC_PREFER
  • AM_DVD_HWDEC_ONLY
  • AM_DVD_SWDEC_PREFER
  • AM_DVD_SWDEC_ONLY

If you have already selected a video renderer by calling IDvdGraphBuilder::GetDvdInterface, do not set the AM_DVD_VMR9_ONLY or AM_DVD_EVR_ONLY flag.

To use the VMR-9, the decoder's IAMDecoderCaps::GetDecoderCaps method must return the AM_GETDECODERCAP_QUERY_VMR9_SUPPORT flag. To use the EVR, the decoder's GetDecoderCaps method must return the AM_GETDECODERCAP_QUERY_EVR_SUPPORT flag.

Requirements

  Header: Dshow.h

See Also