ILTDvdWriter::put_TitleBreak

#include " ILTDvdWriter2.h"

C Syntax

HRESULT ILTDvdWriter_put_TitleBreak(pDVDWriter, newVal)

C++ Syntax

HRESULT put_TitleBreak(newVal)

ILTDvdWriter *pDVDWriter;

pointer to an interface

VARIANT_BOOL newVal;

title break

Sets a value that determines whether a title is closed immediately after a write operation.

Parameter Description
pDVDWriter Pointer to an ILTDvdWriter interface.
newVal Value that indicates whether a title is closed immediately after a write operation. Possible values are:
  Value Meaning
  VARIANT_TRUE The title will be closed immediately after the write operation.
  VARIANT_FALSE The title will remain open immediately after the write operation.

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

Once all chapters have been added to a title, close the title by calling ILTDvdWriter::put_TitleBreak with the newVal parameter set to VARIANT_TRUE.

To get the current setting, call ILTDvdWriter::get_TitleBreak.

If TitleBreak is set to VARIANT_FALSE, the current title will stay open, and each conversion will create a chapter in the current title. The chapters are stored in temporary files in a different folder than the DVD image folder. The temporary files will not be copied to the DVD image folder until the TitleBreak property is set to VARIANT_TRUE. If the convert object is destroyed or the output type changed before TitleBreak is set to VARIANT_TRUE, the temporary files will be deleted and nothing will be written to the DVD image folder.

If TitleBreak is set to VARIANT_TRUE each conversion will create a new title at the end of the conversion. Also, the moment TitleBreak is set to VARIANT_TRUE, any temporary files created by previous conversions will be merged into the same title. Each converted file will appear as a different chapter in the same title.

For example, this sequence:

TitleBreak = VARIANT_FALSE
Convert File 1 convert file 1 as Chapter 1
Convert File 2 convert file 2 as Chapter 2
TitleBreak = VARIANT_TRUE Create Title 1
Destroy the converter object

will create a DVD with 1 title containing 2 chapters

But this sequence:

TitleBreak = VARIANT_FALSE
Convert File 1 convert file 1 as Chapter 1
Convert File 2 convert file 2 as Chapter 2
Destroy the converter object

will not create anything.

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

Elements:

ILTDvdWriter::getTempPath, ILTDvdWriter::put_TempPath, ILTDvdWriter::ClearTitleSet, ILTDvdWriter::get_Overwrite, ILTDvdWriter::put_Overwrite, ILTDvdWriter::getTitleBreak

Topics:

Multimedia Function Group

 

The LEAD DVD Writer and Menus Titles and Chapters

 

How to Use the DVD Writer to Write a DVD Image

 

DVD Function Groups

 

Streaming Function Groups

Example

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

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Multimedia C API Help