__MIDL___MIDL_itf_strmif_0000_0132_0003 Enumeration

The DVD_OPTION_FLAG enumeration defines flags that control the behavior of the DVD Navigator Filter. To set any of these flags, call IDvdControl2::SetOption.

Syntax

typedef enum __MIDL___MIDL_itf_strmif_0000_0132_0003 {
  DVD_ResetOnStop                      ,
  DVD_NotifyParentalLevelChange        ,
  DVD_HMSF_TimeCodeEvents              ,
  DVD_AudioDuringFFwdRew               ,
  DVD_EnableNonblockingAPIs            ,
  DVD_CacheSizeInMB                    ,
  DVD_EnablePortableBookmarks          ,
  DVD_EnableExtendedCopyProtectErrors  ,
  DVD_NotifyPositionChange             ,
  DVD_IncreaseOutputControl            ,
  DVD_EnableStreaming                  ,
  DVD_EnableESOutput                   ,
  DVD_EnableTitleLength                ,
  DVD_DisableStillThrottle             ,
  DVD_EnableLoggingEvents              ,
  DVD_MaxReadBurstInKB                 ,
  DVD_ReadBurstPeriodInMS              ,
  DVD_RestartDisc                      ,
  DVD_EnableCC
} DVD_OPTION_FLAG;

Constants

DVD_ResetOnStop Specifies whether the DVD Navigator returns to the start of the disc when the graph stops.
Value Description
TRUE The DVD Navigator enters the DVD Stop domain when the filter graph stops. When playback resumes, it starts at the beginning of the disc.
FALSE The DVD Navigator does not enter the DVD Stop domain when the filter graph stops. When the filter graph starts again, playback resumes from the point where it stopped.
 

The default value is TRUE.

The default behavior is not always desirable, because the filter graph might be stopped unexpectedly. This can happen, for example, if the screen resolution changes, a screen saver starts, or the computer goes into suspended mode. In these situations, the user probably wants playback to restart from the same point. Typically, the application should set this flag to FALSE immediately before calling IMediaControl::Run. It should set the flag to TRUE before calling IMediaControl::Stop in response to an explicit user to command to stop playback.

DVD_NotifyParentalLevelChange Specifies whether the DVD Navigator notifies the application when the parental level changes on the disc.
Value Description
TRUE If the DVD Navigator reaches a temporary parental management level command, it sends the application an EC_DVD_PARENTAL_LEVEL_CHANGE event. It blocks playback until it the application responds by calling IDvdControl2::AcceptParentalLevelChange.
FALSE When the DVD Navigator encounters a temporary parental management level command and the current parental level is too low, the Navigator automatically rejects the command and branches to whatever path the disc specifies. The Navigator sends an EC_DVD_PARENTAL_LEVEL_CHANGE event indicating the required level. The application can stop playback, put up a password dialog box, and restart playback so that it can succeed on the next attempt.
 

The default value FALSE.

DVD_HMSF_TimeCodeEvents Specifies the format for timecode information.
Value Description
TRUE The DVD Navigator sends all timecode information using the DVD_HMSF_TIMECODE structure.
FALSE The DVD Navigator sends timecode information using binary coded decimal (BCD) format, which is defined in the DVD_TIMECODE structure.
 

For backward compatibility, the default value is FALSE, but the DVD_HMSF_TIMECODE format is easier to use.

DVD_AudioDuringFFwdRew Specifies the format for timecode information.
Value Description
TRUE The DVD Navigator enables audio during fast forward and rewind, as long as the audio rate does not exceed the maximum rate of the audio decoder.
FALSE The Navigator disables audio during fast forward and rewind.
 

The default value is FALSE.

You can also enable audio during fast forward and rewind by creating the following key in the Windows registry:

DWORD HKLM\Software\Microsoft\DVDNavigator\AudioDuringFFwdRev = 1

This has the same effect as setting the DVD_AudioDuringFFwdRew flag to TRUE.

DVD_EnableNonblockingAPIs
Note  Requires Windows XP Service Pack 2 or later.
 

If this flag is FALSE, certain DVD Navigator functions block until the DVD Navigator can complete the operation. This is the default behavior.

If this flag is TRUE, those functions no longer block. Instead, if the DVD Navigator cannot complete the operation immediately, the function returns VFW_E_DVD_NONBLOCKING. If the application sets this flag to TRUE, it must handle the VFW_E_DVD_NONBLOCKING error code. Usually the correct behavior is to poll the function until the function succeeds or returns some other error code.

This flag affects at least the following methods: IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState. This list may be expanded in the future.

DVD_CacheSizeInMB
Note  Requires Windows Vista or later.
 

Specifies how much data the DVD Navigator reads in advance, in MB. For this flag, the bEnable parameter of SetOption is interpreted as a DWORD value, rather than a Boolean.

If the application sets this flag to a large value (> 50 MB), the DVD drive may spin down after the initial pre-fetch, depending on the hardware.

You can also set the cache size by creating the following registry key: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. This registry key is intended for diagnostic purposes only. Applications should use the DVD_CacheSizeInMB flag, not the registry key.

DVD_EnablePortableBookmarks
Note  Requires Windows Vista or later.
 
Value Description
TRUE DVD bookmarks can be used on another computer. See Saving and Restoring DvdState Objects.
FALSE DVD bookmarks are usable only on the computer where they were created.
 

The default value is FALSE.

DVD_EnableExtendedCopyProtectErrors
Note  Requires Windows Vista or later.
 

If this flag TRUE, the DVD Navigator supports an extended set of errors related to copy protection failures. These errors are conveyed through the EC_DVD_ERROR event, and include the following:

  • DVD_PB_STOPPED_CopyProtectOutputNotSupported
  • DVD_PB_STOPPED_CopyProtectOutputFailure
(See DVD_PB_STOPPED.)

If this flag is FALSE, all copy protection errors are reported using the general DVD_PB_STOPPED_CopyProtectFailure error code.

For backward compatibility, the default value is FALSE.

DVD_NotifyPositionChange
Note  Requires Windows 7 or later.
 

If this flag is TRUE, the following events are enabled:

The default value for this flag is FALSE.
DVD_IncreaseOutputControl
Note  Requires Windows 7 or later.
 

Bitwise OR of the following flags:

Flag Description
0x01 Enforce High-Bandwidth Digital Content Protection (HDCP) without fallback.
0x02 Enforce HDCP even for DVD discs that do not have Content Scramble System (CSS) protection.
 

The default value is zero. These flags are intended for purposes. The recommended value is zero.

DVD_EnableStreaming
Note  Requires Windows 7 or later.
 

Enables or disables streaming mode. In streaming mode, bad blocks on the disc are skipped. The DVD Navigator receives partially corrected data. This mode generally produces better results when playing scratched or damaged disks, because it results in brief video corruption, rather than long waits that block playback. The DVD drive must support streaming I/O.

The default value is TRUE.

DVD_EnableESOutput
Note  Requires Windows 7 or later.
 

Enables the DVD Navigator to output elementary streams. For more information, see the media types listed in the topic DVD Navigator Filter.

The default value is FALSE.

DVD_EnableTitleLength
Note  Requires Windows 7 or later.
 
Value Description
TRUE The IDvdInfo2::GetTitleAttributes method returns the length of the title in the DVD_TitleAttributes structure.
FALSE The GetTitleAttributes method returns the title mode (karaoke mode or other mode) and not the title length.
 

The default value is FALSE.

DVD_DisableStillThrottle If this flag is TRUE, it disables a call to Sleep(1) that the Navigator otherwise makes when displaying stills.

For backward compatibility, the default value for this flag is FALSE, but the recommended value is TRUE.

Note  Requires Windows 7 or later.
 
DVD_EnableLoggingEvents
Note  Requires Windows 7 or later.
 

If this flag is TRUE, the following events are enabled:

The default value for this flag is FALSE.
DVD_MaxReadBurstInKB
Note  Requires Windows 7 or later.
 

The maximum amount of data that the DVD Navigator will read ahead in a single burst, in kilobytes. For this flag, the bEnable parameter of SetOption is interpreted as a DWORD value.

The default value is 128 KB.

DVD_ReadBurstPeriodInMS
Note  Requires Windows 7 or later.
 

How often to perform burst reads into the cache, in milliseconds. For this flag, the bEnable parameter of SetOption is interpreted as a DWORD value.

The default value is 250 milliseconds.

DVD_RestartDisc
DVD_EnableCC

Remarks

The following table lists the default values for the Boolean flags.

Flag Default value
DVD_AudioDuringFFwdRew FALSE
DVD_DisableStillThrottle FALSE
DVD_EnableESOutput FALSE
DVD_EnableExtendedCopyProtectErrors FALSE
DVD_EnableLoggingEvents FALSE
DVD_EnableNonblockingAPIs FALSE
DVD_EnableStreaming TRUE
DVD_EnablePortableBookmarks FALSE
DVD_EnableTitleLength FALSE
DVD_HMSF_TimeCodeEvents FALSE
DVD_NotifyParentalLevelChange FALSE
DVD_NotifyPositionChange FALSE
DVD_ResetOnStop TRUE

Requirements

   
Header strmif.h (include Dshow.h)

See Also

DirectShow Enumerated Types

IDvdControl2::SetOption