ILTDVDBurner::GetProgress

Summary

Retrieves the progress of the current operation.

Syntax

Parameters

ILTDVDBurner *pDVDBurner

Pointer to an ILTDVDBurner interface.

long *pState

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

long *pProgress

Pointer to a variable to be updated with an LTDVDBurner_Progress value describing the progress of the current operation.

long *pComplete

Pointer to a variable to be updated with the current operation completion status. Possible values range from 0 to 10000, where the value 0 means 0% completed and the value 10000 means 100% completed.

BSTR *pDescription

Pointer to a character string to be updated with a description of either the current step being performed, or the current encountered error.

Returns

Comments

If the function succeeds, the user is responsible for freeing the string retrieved in pDescription by calling SysFreeString.

Required DLLs and Libraries

• LTDVDBrn
• DSKernel (Multimedia toolkits) or LTKRN (Imaging, 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::get_State

Topics

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

Example

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

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