#include "ILTDvdWriter2.h"
C Syntax |
HRESULT ILTDvdWriter_AddMenuTitle(pDVDWriter, Title , Index) |
C++ Syntax |
HRESULT AddMenuTitle(Title, Index) |
ILTDvdWriter *pDVDWriter; |
pointer to an interface |
BSTR Title; |
title text |
long Index; |
title index |
Adds a new title to the menu.
Parameter |
Description |
pDVDWriter |
Pointer to an ILTDvdWriter interface. |
Title |
A character string that contains the title text that will appear in the menu. |
Index |
A zero-based index of the title; where the title will be inserted in the list of titles. Pass -1 to append the title to the end of the list. |
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. |
The title list can be modified at any time before writing the menu. A maximum of 36 titles can be added. Calling ILTDvdWriter::AddMenuTitle with an existing index will not make an update: it will insert a new title at the specified index and shift the list down.
Menu writing should be the last step in a DVD image authoring process. Writing the menu first will cause an error and if a new title is written after the menu has been written, then the menu will be destroyed.
Any multimedia file can be used as the menu background, including a single page image, a multipage image, or a video. All menus require a background video. To add menus to the DVD image, perform the following steps:
1. |
Add menu titles by calling the ILTDvdWriter::AddMenuTitle function. |
2. |
Call the ILTDvdWriter::put_TitleMenu, passing VARIANT_TRUE to the newVal parameter. |
3. |
Convert the background image for the menu. This is a standard DVD conversion graph, only the video will be used for the menu background. |
4. |
Call ILTDvdWriter::put_TitleMenu, passing VARIANT_FALSE for the newVal parameter to close the "menu write" mode. This merges the menu subtitle information with the background video and modifies the DVD image. |
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. |
Functions: |
ILTDvdWriter::RemoveMenuTitle, ILTDvdWriter::RemoveAllMenuTitles, ILTDvdWriter::get_MenuTitleCount, ILTDvdWriter::GetMenuTitle |
Topics: |
|
|
|
|
|
|
|
|
For a C example, refer to Creating DVD Images for C.
For a C++ example, refer to Creating DVD Images for C++.
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.