ILTDvdWriter::get_MenuLoop

#include "ILTDvdWriter2.h"

C Syntax

HRESULT ILTDvdWriter_get_MenuLoop(pDVDWriter, pVal)

C++ Syntax

HRESULT get_MenuLoop(pVal)

ILTDvdWriter *pDVDWriter;

pointer to an interface

VARIANT_BOOL *pVal;

pointer to a variable

Retrieves the loop behavior of the menu background.

Parameter Description
pDVDWriter Pointer to an ILTDvdWriter interface.
pVal Pointer to a variable to be updated with a value that determines the loop behavior of the menu background. Possible values are:
  Value Meaning
  VARIANT_TRUE The menu background will loop continuously.
  VARIANT_FALSE The menu background video will be played once. This is the default value.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

It is recommended that you do not enable the menu loop if you create the menu background from a still image. If the background is a still image, there is no reason to loop, since the image never changes.

It is also not recommended to use menu loop if the background contains a very short video. Some DVD drives take some time to restart playing the background and that can cause undesired effects. If you still want to use menu loop with a short video clip, you might obtain better results to concatenate the clip several times and then use this longer clip as a menu. Example: you want to use a 1 sec clip as the menu in a continuous loop. You can concatenate the clip 8 times, create a 8-sec video clip containing your original clip playing 8 times. You can now use this 8-sec clip as background and enable the menu loop.

Required DLLs and Libraries

LTDVDWRT
DSKernel

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help
Introduction
Version History
Getting Started
Copyright Notice
Directories
Multimedia Files You Must Include With Your Application (Redistributables)
Frequently Asked Questions
LEADTOOLS Multimedia Features
Add-on Modules
Programming with LEADTOOLS Multimedia
Appendix
LEADTOOLS Licensing