IDvdControl2::SetOption

  • Article
 
Microsoft DirectShow 9.0

IDvdControl2::SetOption

The SetOption method enables or disables an internal behavior flag on the DVD Navigator filter.

Syntax

  HRESULT SetOption(
  DVD_OPTION_FLAG flag,
  BOOL bEnable
);

Parameters

flag

[in] Specifies which behavior to modify, as a member of the DVD_OPTION_FLAG enumeration type. For details, see the DVD_OPTION_FLAG reference page.

bEnable

[in] Boolean value that specifies whether to enable to disable the behavior flag given in the flag parameter.

Return Values

Returns one of the following values.

Return code Description
S_OK Success.
E_INVALIDARG Invalid flag.

Remarks

The following flags are suppored. For more information, see the DVD_OPTION_FLAG Enumeration.

Flag Description
DVD_AudioDuringFFwdRew Specifies whether the DVD Navigator enables audio during fast forward and rewind.
DVD_HMSF_TimeCodeEvents Specifies the format for timecode information.
DVD_NotifyParentalLevelChange Specifies whether the DVD Navigator notifies the application when the parental level changes.
DVD_ResetOnStop Specifies whether the DVD Navigator returns to the start of the disc when the graph stops.

Call SetOption with the desired flags immediately after creating an instance of the DVD Navigator and whenever you want to change any behaviors.

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
None All

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also