In This Topic ▼

ILTDVDBurner::get_State

#include "ILTDVDBurner2.h"

C Syntax HRESULT ILTDVDBurner_get_State(pDVDBurner, pVal)

C++ Syntax HRESULT get_State(pVal)

Retrieves the burner's state.

Parameters

Pointer to a variable to be updated with an LTDVDBurner_State value describing the burner's state.

Value	Meaning
S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes.

The following is a list of all possible operations with the required state for each operation:

Operation	Required State
Write	Idle
Erase	Idle
Cancel	Any
RefreshDriveList	Idle
get_DriveCount	Any
get_CurrentDrive	Any
GetDriveName	Any
get_InputPath	Any
put_InputPath	Idle
get_VolumeName	Any
put_VolumeName	Idle
get_LastError	Any
get_State	Any
GetProgress	Any
EjectDisc	Idle
get_AutoEject	Any
put_AutoEject	Idle
get_Eraseable	Idle
get_Writeable	Idle
get_Ejectable	Idle
get_ISOOutputFile	Any
put_ISOOutputFile	Idle
get_DiscType	Any (preferred when Idle to get a fresh profile)
GetDiscTypeName	Any
RefreshSpeedList	Idle
get_CurrentSpeed	Any
put_CurrentSpeed	Idle
GetSpeedValue	Any
GetSpeedName	Any
get_SpeedListChanged	Idle (will return VARIANT_FALSE without checking if called in a different state).
get_DiscCapacity	Idle (will return zero without checking if called in a different state).
LoadDisc	Idle
get_Loadable	Idle (will return VARIANT_FALSE without checking if called in a different state).
get_TestWriteable	Idle (will return VARIANT_FALSE without checking if called in a different state).
get_SpeedCount	Any
get_SystemSupported	Any
GetDriveId	Any
get_ImageSize	Idle (will return zero without checking if called in a different state).
GetDriveDiscTypeCount	Any
GetDriveDiscType	Any
GetDiscTypeWriteable	Any
ResetToDefaults	Idle

Required DLLs and Libraries

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

Win32, x64