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.

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