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