ILTDvdWriter::get_Overwrite

#include " ILTDvdWriter2.h"

C Syntax

HRESULT ILTDvdWriter__get_Overwrite(pDVDWriter, Overwrite)

C++ Syntax

HRESULT get_Overwrite(Overwrite)

 

ILTDvdWriter *pDVDWriter;

/* pointer to an interface */

VARIANT_BOOL *Overwrite;

/* pointer to a variable */

Retrieves the image overwrite status of the DVD writer.

Parameter

Description

pDVDWriter

Pointer to an ILTDvdWriter interface.

Overwrite

Pointer to a variable to be updated with a value that indicates whether the existing DVD image A set of files that contain all of the video and audio content for a DVD, organized with a table of contents (optional). See also: Title, Chapter The name for each individual video file on a DVD. For example, under the title "Water Skiing", you might have the chapters "My first try," "My first wreck," and "My first jump.", ISO Image An ISO image (.iso) is a disk image of a file system. It includes data files that are contained in the ISO image along with filesystem metadata. ISO images are an alternative to physical media for distribution of a "DVD" over the Internet. Most operating systems allow ISO images images to be "played" as if they were physical discs. See also: DVD Image.. will be overwritten. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

The DVD writer will delete (overwrite) the existing DVD image at the next write operation.

 

VARIANT_FALSE

The DVD writer will append new titles to the existing DVD image at the next 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

To add a new 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. to the DVD image being created, overwriting must be disabled before writing the image. To disable overwriting, call ILTDvdWriter::put_Overwrite with the Overwrite parameter set to VARIANT_FALSE.

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::get_TitleBreak, ILTDvdWriter::put_TitleBreak, ILTDvdWriter::ClearTitleSet, ILTDvdWriter::get_TempPath, 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++.