ILTDVDBurner::GetDriveDiscType

#include "ILTDVDBurner2.h"

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 */

Retrieves the supported disc type by the specified drive at the specified type index.

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.

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_DriveCount, ILTDVDBurner::GetDriveDiscTypeCount

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::GetDriveDiscType Example for C.

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