Help Version 19.0.2017.10.27
References ▼
#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. | |
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. |
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 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
For a C example, refer to Creating DVD Images for C.
For a C++ example, refer to Creating DVD Images for C++.
Raster .NET | C API | C++ Class Library | JavaScript HTML5
Document .NET | C API | C++ Class Library | JavaScript HTML5
Medical .NET | C API | C++ Class Library | JavaScript HTML5
Medical Web Viewer .NET