ILTDVDBurner::GetDriveDiscType

C Syntax

HRESULT LTDVDBurner_getDriveDiscType(pDVDBurner, Drive, Index, pVal)

C++ Syntax

HRESULT GetDriveDiscType(Drive, Index, pVal)

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

long Drive;

/* driver */

long Index;

/* type index */

long *pVal;

/* pointer to a variable */

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

Drive

The zero based index of drive for which to retrieve the supported type at the specified index.

Index

The zero based index of the type to be retrieved.

pVal

Pointer to a variable to be updated with 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

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.

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.

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.

Functions:

ILTDVDBurner::get_DriveCount, ILTDVDBurner::GetDriveDiscTypeCount

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups