In This Topic ▼

ILTDvdWriter::get_MenuLoop

Summary

Retrieves the loop behavior of the menu background.

Syntax

#include "ILTDvdWriter2.h"

Language	Syntax
C	HRESULT ILTDvdWriter_get_MenuLoop(pDVDWriter, pVal)
C++	HRESULT get_MenuLoop(pVal)

Parameters

ILTDvdWriter *pDVDWriter

Pointer to an ILTDvdWriter interface.

VARIANT_BOOL *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

Value	Meaning
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.