MSVidWebDVD.SaveBookmark Method

 
Microsoft DirectShow 9.0

MSVidWebDVD.SaveBookmark Method

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.

Syntax

  VidWebDVD
  .SaveBookmark

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
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.

Example

  oVidWebDVD
  .SaveBookmark

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