In This Topic ▼

ILTDVDBurner::get_ReserveCDTrackOnWriting

Summary

Indicates whether the size of a CD track can be reserved before performing the write operation.

Syntax

#include "ILTDVDBurner2.h"

Platform	Syntax
C	HRESULT ILTDVDBurner_get_ReserveCDTrackOnWriting(pDVDBurner, pVal)
C++	HRESULT get_ReserveCDTrackOnWriting(pVal)

Parameters

ILTDVDBurner * pDVDBurner

Pointer to an ILTDVDBurner interface.

VARIANT_BOOL *pVal

Pointer to a variable to be updated with a value indicating whether to reserve the size of a CD track before performing the write operation. Possible values are:

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

Comments

Use this method to reserve disc space for a logical track.

Some drives expect such reservation when a write operation is issued (especially when overburning).

Only CD, CD-R, and CD-RW media support CD track reservation.

Required DLLs and Libraries

LTDVDBrn
DSKernel (Multimedia toolkits) or 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.