Export (0) Print
Expand All
Expand Minimize

DVD_OPTION_FLAG 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  { 
  DVD_ResetOnStop                      = 1,
  DVD_NotifyParentalLevelChange        = 2,
  DVD_HMSF_TimeCodeEvents              = 3,
  DVD_AudioDuringFFwdRew               = 4,
  DVD_EnableNonblockingAPIs            = 5,
  DVD_CacheSizeInMB                    = 6,
  DVD_EnablePortableBookmarks          = 7,
  DVD_EnableExtendedCopyProtectErrors  = 8,
  DVD_NotifyPositionChange             = 9,
  DVD_IncreaseOutputControl            = 10,
  DVD_EnableStreaming                  = 11,
  DVD_EnableESOutput                   = 12,
  DVD_EnableTitleLength                = 13,
  DVD_DisableStillThrottle             = 14,
  DVD_EnableLoggingEvents              = 15,
  DVD_MaxReadBurstInKB                 = 16,
  DVD_ReadBurstPeriodInMS              = 17
} DVD_OPTION_FLAG;

Constants

DVD_ResetOnStop

Specifies whether the DVD Navigator returns to the start of the disc when the graph stops.

ValueDescription
TRUEThe DVD Navigator enters the DVD Stop domain when the filter graph stops. When playback resumes, it starts at the beginning of the disc.
FALSEThe 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.

ValueDescription
TRUEIf 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.
FALSEWhen 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.

ValueDescription
TRUEThe DVD Navigator sends all timecode information using the DVD_HMSF_TIMECODE structure.
FALSEThe 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.

ValueDescription
TRUEThe 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.
FALSEThe 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.

ValueDescription
TRUEDVD bookmarks can be used on another computer. See Saving and Restoring DvdState Objects.
FALSEDVD 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:

FlagDescription
0x01Enforce High-Bandwidth Digital Content Protection (HDCP) without fallback.
0x02Enforce 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.

ValueDescription
TRUEThe IDvdInfo2::GetTitleAttributes method returns the length of the title in the DVD_TitleAttributes structure.
FALSEThe 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.

Remarks

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

Flag Default value
DVD_AudioDuringFFwdRewFALSE
DVD_DisableStillThrottleFALSE
DVD_EnableESOutputFALSE
DVD_EnableExtendedCopyProtectErrorsFALSE
DVD_EnableLoggingEventsFALSE
DVD_EnableNonblockingAPIsFALSE
DVD_EnableStreamingTRUE
DVD_EnablePortableBookmarksFALSE
DVD_EnableTitleLengthFALSE
DVD_HMSF_TimeCodeEventsFALSE
DVD_NotifyParentalLevelChangeFALSE
DVD_NotifyPositionChangeFALSE
DVD_ResetOnStopTRUE

 

Requirements

Header

Strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types
IDvdControl2::SetOption

 

 

Community Additions

ADD
Show:
© 2014 Microsoft