IDvdControl2::SetOption method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The SetOption method enables or disables an internal behavior flag on the DVD Navigator filter.
Syntax
HRESULT SetOption(
[in] DVD_OPTION_FLAG flag,
[in] BOOL fState
);
Parameters
[in] flag
Specifies which behavior to modify, as a member of the DVD_OPTION_FLAG enumeration type.
[in] fState
Specifies the new value of the option given in the flag parameter.
DVD_OPTION_FLAG reference page.
Return value
Returns one of the following values.
| Return code | Description |
|---|---|
|
Success. |
|
Invalid flag. |
Remarks
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |