In This Topic ▼

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

Example

For a C example, refer to Creating DVD Images for C.

For a C++ example, refer to Creating DVD Images for C++.

Download our FREE evaluation

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

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

Functions:	ILTDvdWriter::put_MenuLoop, ILTDvdWriter::get_MenulessTitlePlay
Topics:	Streaming Function Groups, Multimedia Function Group, DVD Function Groups, The LEAD DVD Writer and Menus Titles and Chapters