Collapse All Expand All

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

See Also

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

Example

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

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