In This Topic ▼

ILTDVDBurner::put_ReserveCDTrackOnWriting

Include

#include "ILTDVDBurner2.h"

Syntax

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

Data Type	Description
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	Meaning of Value
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
	VARIANT_TRUE	Reserve CD track's size before performing the write operation.
	VARIANT_FALSE	Do not reserve CD track's size before performing 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.

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