Microsoft DirectX 9.0

MSVidWebDVD.RestorePreferredSettings Method

This topic applies to Windows XP Service Pack 1 only.

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

See Also