ILTDVDBurner::get_SpeedListChanged

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner__get_SpeedListChanged(pDVDBurner, pVal)

C++ Syntax

HRESULT get_SpeedListChanged(pVal)

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

VARIANT_BOOL *pVal;

/* pointer to a variable */

Retrieves a value that indicates whether the list of supported speeds has changed.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

pVal

Pointer to a variable to be updated with a value that indicates whether the speed list has changed from the last call for the put_CurrentDrive or RefreshSpeedList functions. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

The supported speed list has changed. The new list can be enumerated using ILTDVDBurner::get_SpeedCount, ILTDVDBurner::GetSpeedName, and ILTDVDBurner::GetSpeedValue.

 

VARIANT_FALSE

The supported speed has not changed since that last time ILTDVDBurner::RefreshSpeedList or ILTDVDBurner::put_CurrentDrive was called.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes.

Comments

If the burner is not in the idle state, the returned value in the pVal parameter will be VARIANT_FALSE.

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::put_CurrentSpeed, ILTDVDBurner::GetSpeedValue, ILTDVDBurner::GetSpeedName

Topics:

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

Example

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

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