References ▼
Retrieves the burner's state.
#include "ILTDVDBurner2.h"
| Platform | Syntax |
|---|---|
| C | HRESULT ILTDVDBurner_get_State(pDVDBurner, pVal) |
| C++ | HRESULT get_State(pVal) |
Pointer to an ILTDVDBurner interface.
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_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 |
Win32, x64
For a C example, refer to ILTDVDBurner::get_State Example for C.
For a C++ example, refer to ILTDVDBurner::get_State Example for C++.