In This Topic ▼

ILTDvdWriter::put_TitleBreak

Summary

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

Syntax

#include "ILTDvdWriter2.h"

Language	Syntax
C	HRESULT ILTDvdWriter_put_TitleBreak(pDVDWriter, newVal)
C++	HRESULT put_TitleBreak(newVal)

Parameters

ILTDvdWriter *pDVDWriter

Pointer to an ILTDvdWriter interface.

VARIANT_BOOL 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

Value	Meaning
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.