ILTDVDBurner::GetDiscTypeWriteable

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner__getDiscTypeWriteable(pDVDBurner, type, pVal)

C++ Syntax

HRESULT GetDiscTypeWriteable(type, pVal)

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

long type;

/* disc type */

VARIANT_BOOL *pVal;

/* pointer to a variable */

Retrieves a value that indicates whether the disc type is writeable.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

type

Value that represents the type of the disc that is being checked for writeability.  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

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 recordable (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 disc is usually housed in a cartridge.

 

LTDVDBurner_DiscType_DVDPLUSRW

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

pVal

Pointer to a variable to be updated with a value that indicates whether the disc type is writeable. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

The disc type is writeable.

 

VARIANT_FALSE

The disc type is not writeable.

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.

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.

See Also

Functions:

ILTDVDBurner::get_DiscType, ILTDVDBurner::GetDiscTypeName

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function GroupsHow to use the DVD Burner to burn ISO files and DVD images, Functions

Example

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

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