ILTDVDBurner::get_State

#include "ILTDVDBurner2.h"

C Syntax	HRESULT LTDVDBurner_get_State(pDVDBurner, pVal)
C++ Syntax	HRESULT get_State(pVal)

ILTDVDBurner *pDVDBurner;	/* pointer to an interface */
long *pVal;	/* pointer to a variable */

Retrieves the burner state.

Parameter	Description
pDVDBurner	Pointer to an ILTDVDBurner interface.
pVal	Pointer to a variable to be updated with the burner state. Possible values are:
	Value	Meaning
	LTDVDBurner_State_Idle	[0] The burner is in the idle state. Operations and checks that require the burner to be in the idle state can be performed now.
	LTDVDBurner_State_Writing	[1] The burner is performing a writing operation. Certain operations and checks cannot be performed while the burner is in this state.
	LTDVDBurner_State_TestWriting	[2] The burner is performing a writing test. Certain operations and checks cannot be performed while the burner is in this state.
	LTDVDBurner_State_Erasing	[3] The burner is performing an erasing operation. Certain operations and checks cannot be performed while the burner is in this state.

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.

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_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 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.

Win32, x64

Functions:	ILTDVDBurner::GetProgress
Topics:	Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups