In This Topic ▼

ILTDVDBurner::get_ReserveCDTrackOnWriting

Include

#include "ILTDVDBurner2.h"

Syntax

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

Data Type	Description
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	Meaning of Value
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
	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 the 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