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 For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Example
For a C example, refer to Creating DVD Images for C.
For a C++ example, refer to Creating DVD Images for C++.