ILTDvdWriter::put_MenuLoop

#include "ILTDvdWriter2.h"

C Syntax

HRESULT ILTDvdWriter_put_MenuLoop(pDVDWriter, newVal)

C++ Syntax

HRESULT put_MenuLoop(newVal)

 

ILTDvdWriter *pDVDWriter;

/* pointer to an interface */

VARIANT_BOOL newVal;

/* flag */

Sets the loop behavior of the menu background.

Parameter

Description

pDVDWriter

Pointer to an ILTDvdWriter interface.

newVal

Flag 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 not recommended to set the value of the newVal parameter to VARIANT_TRUE if the menu background is a still image.

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::get_MenuLoop, ILTDvdWriter::get_MenulessTitlePlay

Topics:

The LEAD DVD Writer and Menus Titles and Chapters

 

How to Use the DVD Writer to Write a DVD Image

 

Video Streaming Function Groups

 

Multimedia Function Group

 

DVD Function Groups

Example

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

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