ILTDVDBurner::get_ReserveCDTrackOnWriting

Include

#include "ILTDVDBurner2.h"

Syntax


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


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

Summary

Retrieves the reserving CD Track on writing state.

Parameters

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

pVal

Pointer to a variable to be updated with a value that indicates whether reserving the CD track is enabled 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 function 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