MSVidWebDVD.RestorePreferredSettings Method
| Microsoft DirectShow 9.0 |
MSVidWebDVD.RestorePreferredSettings Method
This topic applies to Windows XP Service Pack 1 or later.
The RestorePreferredSettings method restores the registry's DVD default language and level settings.
Syntax
VidWebDVD .RestorePreferredSettings
Parameters
This method takes no parameters.
Return Values
This method does not return a value.
Error Codes
If the property fails, Err.Number may be set to one of the following values.
| Value | Description |
| E_UNEXPECTED | Unspecified error. |
| VFW_E_DVD_INVALIDDOMAIN | Must be in Stop domain for this operation. |
| VFW_E_DVD_OPERATION_INHIBITED | UOP control prohibits the operation. |
Remarks
Properties such as parental level or default audio language that are set using the MSVidWebDVD object are generally applied to the current session only. A user wishing to save these settings as default values in the registry should use the corresponding methods on the MSVidWebDVDAdm object.
Sometimes a user may wish to temporarily change settings, then revert to the saved settings during a viewing session. For example, a parent watching a film may temporarily raise the parental level of the viewer to allow mature content, but wish to restore lower settings after playing a disc. RestorePreferredSettings allows the user to restore the saved DVD language and level settings saved using SaveParentalLevel on the MSVidWebDVDAdm object. The reader must be stopped when executing this method.
Example
oVidWebDVD .RestorePreferredSettings
Valid Domains
The following table shows the domains in which this method is valid.
| Annex J Command Name | Valid Domains |
| DVD_DOMAIN_Stop |
Requirements
Reference: Add a reference to MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
Library: Quartz.dll.
See Also