MSVidWebDVD.SaveBookmark Method

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

The SaveBookmark method saves the current disc position and state of the MSVidWebDVD object so the user can return to the same place later.

VidWebDVD.SaveBookmark

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
E_FAIL Unspecified failure

 

Remarks

A bookmark is a snapshot of the player's current state. This includes information such as where it is playing on the disc, and which audio and subpictures streams are selected. The most common use for bookmarks is to allow the user to stop playback, and even shut down the computer, and come back later to continue viewing the disc right where he or she left off, with all settings just as they were before, avoiding any mandatory playback screens such as the FBI warning. Without using a bookmark, these screens would have to be replayed each time the graph is restarted.

Only one bookmark can be saved at any given time. When you call SaveBookmark, the old bookmark is overwritten.

Examples

oVidWebDVD.SaveBookmark

Requirements

Type Library

MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library

DLL

Quartz.dll

See Also

MSVidWebDVD Object

RestoreBookmark

Saving and Restoring Bookmarks

 

 

Send comments about this topic to Microsoft

Build date: 7/6/2010