ILTDVDBurner::get_DiscType

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner__get_DiscType(pDVDBurner, pVal)

C++ Syntax

HRESULT get_DiscType(pVal)

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

long *pVal;

/* pointer to a variable */

Retrieves the type of the disc in the current drive.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

pVal

Pointer to a variable to be updated with the disc type. Possible values are:

 

Value

Meaning

 

LTDVDBurner_DiscType_None

[-1] No disc in drive.

 

LTDVDBurner_DiscType_Unknown

[0] Unknown disc type.

 

LTDVDBurner_DiscType_CDROM

[1] The disc is a read-only CD-ROM. This disc is NOT recordable.

 

LTDVDBurner_DiscType_DVDROM

[4] The disc is a read-only DVD-ROM. This disc is NOT recordable.

 

Recordable types:

 

LTDVDBurner_DiscType_CDR

[2] The disc is a recordable (write once) CD, CD-R.

 

LTDVDBurner_DiscType_DVDR

[5] The disc is a recordable (write once) DVD-R.

 

LTDVDBurner_DiscType_DVDPLUSR

[9] The disc is a recordable (write once) DVD+R.

 

LTDVDBurner_DiscType_DVDPLUSRDL

[10] The disc is a dual layer record-able (write once) DVD+R DL.

 

Rewriteable types:

 

LTDVDBurner_DiscType_CDRW

[3] The disc is a rewriteable CD-RW.

 

LTDVDBurner_DiscType_DVDRW

[6] The disc is a rewriteable DVD-RW.

 

LTDVDBurner_DiscType_DVDRAM

[7] The disc is a rewriteable DVD-RAM. This type of discs is usually housed in a cartridge.

 

LTDVDBurner_DiscType_DVDPLUSRW

[8] The disc is a rewriteable DVD+RW.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes.

Required DLLs and Libraries

LTDVDBrn

DSKernel (Multimedia toolkit)  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.

Platforms

Win32, x64

See Also

Functions:

ILTDVDBurner::GetDiscTypeName, ILTDVDBurner::GetDiscTypeWriteable, ILTDVDBurner::get_DiscCapacity, ILTDVDBurner::GetDriveDiscType, ILTDVDBurner::GetDriveDiscTypeCount

Topics:

How to use the DVD Burner to burn ISO files and DVD images, Functions

Example

For a C example, refer to ILTDVDBurner::get_DiscType Example for C.

For a C++ example, refer to ILTDVDBurner::get_DiscType Example for C++.