IMSVidWebDVD2::Bookmark Property

[This documentation is preliminary and is subject to change.]
Playback position and state information for a DVD. The playback application can create a DVD bookmark object and persist it to a buffer by calling put_Bookmark or load a persisted bookmark object by calling get_Bookmark.

Syntax

HRESULT put_Bookmark(
  [in]   BYTE *pData,
  [in]   DWORD dwDataLength
);
  
HRESULT get_Bookmark(
  [out]  BYTE **ppData,
  [out]  DWORD *pDataLength
);

Parameters

  • pData [in]
    Pointer to the buffer containing the DVD state information that gets persisted.

  • dwDataLength [in]
    Length of the buffer containing the DVD state information.

  • ppData [out]
    Address of a pointer to the buffer where the DVD state data gets loaded. The get_Bookmark method allocates the memory for this buffer by calling CoTaskMemAlloc and returns the associated pointer in this parameter. The caller is responsible for freeing the memory by calling CoTaskMemFree.

  • pDataLength [out]
    Pointer to a value that gets the length of the buffer where the DVD bookmark data is loaded.

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Client Requires Windows 7.
IDL Declared in Segment.idl.

See Also

IMSVidWebDVD2

Send comments about this topic to Microsoft

Build date: 12/4/2008