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
Saving and Restoring Bookmarks
Send comments about this topic to Microsoft
Build date: 7/6/2010