ILTDVDBurner::put_ReserveCDTrackOnWriting

Include

#include "ILTDVDBurner2.h"

Syntax


C Syntax	HRESULT ILTDVDBurner_put_ReserveCDTrackOnWriting(pDVDBurner, newVal)
C++ Syntax	HRESULT put_ReserveCDTrackOnWriting(newVal)


ILTDVDBurner *pDVDBurner;	/* pointer to an interface */
VARIANT_BOOL newVal;	/* pointer to a variable */

Summary

Changes the reserving CD Track on writing state.

Parameters

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

newVal

Flag that indicates the new state of reserving the CD track before writing on the media. Possible values are:

Value	Meaning
VARIANT_TRUE	Reserve CD track's size before performing the write operation.
VARIANT_FALSE	Don't reserve CD track's size before performing 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.

Remarks

Reserving CD track On writing allows reservation of disc space for logical track.

Some drives expect this reservation when write operation is issued, especially if there is a need to perform overburning.

This property is supported only for media of types CD, CD-R and CD-RW.

Required DLLs and Libraries

LTDVDBrn
DSKernel (Multimedia toolkit)
LTKRN (Imaging Pro, Document, or Medical toolkits)
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