ILTDvdWriter::get_TitleBreak

#include " ILTDvdWriter2.h"

C Syntax	HRESULT ILTDvdWriter_get_TitleBreak(pDVDWriter, TitleBreak)
C++ Syntax	HRESULT get_TitleBreak(TitleBreak)

ILTDvdWriter *pDVDWriter;	/* pointer to an interface */
VARIANT_BOOL *TitleBreak;	/* pointer to a variable */

Retrieves a value that indicates whether a title The name for a group of related video files (called "Chapters") on your DVD. For example, for a DVD called "My Summer Vacation," you might have the titles "Water Skiing," "New Friends," and "Hiking." For each of those titles, you might have one or more different video files. is closed immediately after a write operation.

Parameter	Description
pDVDWriter	Pointer to an ILTDvdWriter interface.
TitleBreak	Pointer to a variable to be updated with a 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 TitleBreak parameter set to VARIANT_TRUE.

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::put_Overwrite, ILTDvdWriter::getTempPath, ILTDvdWriter::put_TitleBreak, ILTDvdWriter::ClearTitleSet, ILTDvdWriter::get_Overwrite, ILTDvdWriter::put_TempPath
Topics:	Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups, The LEAD DVD Writer and Menus Titles and Chapters

Example

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

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