ILTDVDBurner::get_State

Summary

Retrieves the burner's state.

Syntax

#include "ILTDVDBurner2.h"
Platform Syntax
C HRESULT ILTDVDBurner_get_State(pDVDBurner, pVal)
C++ HRESULT get_State(pVal)

Parameters

ILTDVDBurner *pDVDBurner

Pointer to an ILTDVDBurner interface.

long *pVal

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

Returns

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

Comments

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_Erasable 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

Platforms

Win32, x64

See Also

Functions

Topics

Example

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

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

Help Version 23.0.2024.3.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Media Writer C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.