MSVidWebDVD.RestorePreferredSettings Method

Article
01/07/2009

Note This topic applies to Windows XP Service Pack 1 or later.

The RestorePreferredSettings method restores the registry's DVD default language and level settings.

VidWebDVD.RestorePreferredSettings

Parameters

This method takes no parameters.

Return Value

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.

Valid Domains

The following table shows the domains in which this method is valid.

Annex J Command Name	Valid Domains
None	DVD_DOMAIN_Stop

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.

Examples

oVidWebDVD.RestorePreferredSettings

Requirements

Type Library	Use MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
DLL	Requires Quartz.dll.

Share via