LEADTOOLS Multimedia (Leadtools.MediaWriter assembly) Send comments on this topic. | Main Raster Introduction | Multimedia Introduction | Help Version 17.0.3.24
BurnDisc Method
See Also 
Leadtools.MediaWriter Namespace > MediaWriterDrive Class : BurnDisc Method



discProps
A disc properties object created by MediaWriterDrive.CreateDisc

The BurnDisc Method is available in LEADTOOLS LEADTOOLS Document and Medical Imaging and in LEADTOOLS DVD Module toolkits.

discProps
A disc properties object created by MediaWriterDrive.CreateDisc
Performs actual burning of an .ISO image or selected folder path to the disc in the current drive.

Syntax

Visual Basic (Declaration) 
Public Sub BurnDisc( _
   ByVal discProps As MediaWriterDisc _
) 
Visual Basic (Usage)Copy Code
Dim instance As MediaWriterDrive
Dim discProps As MediaWriterDisc
 
instance.BurnDisc(discProps)
C# 
public void BurnDisc( 
   MediaWriterDisc discProps
)
C++/CLI 
public:
void BurnDisc( 
   MediaWriterDisc^ discProps
) 

Parameters

discProps
A disc properties object created by MediaWriterDrive.CreateDisc

Example

Visual BasicCopy Code
<Test> _
   Public Sub BurnDiscExample()
      Try
         Dim writer As MediaWriter = New MediaWriter()
         Dim drives As List(Of MediaWriterDrive) = writer.Drives
         Dim drive As MediaWriterDrive = drives(1)
         Dim disc As MediaWriterDisc = drive.CreateDisc()
         disc.VolumeName = "TEST DISC"
         disc.SourcePathName = Path.Combine(LEAD_VARS.ImagesDir, "InputFiles")

         drive.AutoEject = True

         AddHandler drive.OnProgress, AddressOf BurnProgress

         drive.LoadDisc()
         drive.BurnDisc(disc)

         ' wait loop for demonstration purposes
         Do While drive.State <> MediaWriterState.StateIdle
            System.Windows.Forms.Application.DoEvents()
            System.Threading.Thread.Sleep(10)
         Loop

         RemoveHandler drive.OnProgress, AddressOf BurnProgress

      Catch ex As Exception
         Assert.Fail("Test Failed: " & ex.Message)
      End Try
   End Sub

   Public Sub BurnProgress(ByVal sender As Object, ByVal evt As MediaWriterProgressEventArgs)
      System.Diagnostics.Debug.WriteLine(evt.ToString())
   End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void BurnDiscExample()
   {
      try
      {
         MediaWriter writer = new MediaWriter();
         List<MediaWriterDrive> drives = writer.Drives;
         MediaWriterDrive drive = drives[1];
         MediaWriterDisc disc = drive.CreateDisc();

         disc.VolumeName = "TEST DISC";
         disc.SourcePathName = Path.Combine(LEAD_VARS.ImagesDir, "InputFiles");

         drive.AutoEject = true;

         drive.OnProgress += BurnProgress;

         drive.LoadDisc();

         // BurnDisc starts
         drive.BurnDisc(disc);

         // wait loop for demonstration purposes
         while (drive.State != MediaWriterState.StateIdle)
         {
            System.Windows.Forms.Application.DoEvents();
            System.Threading.Thread.Sleep(10);
         }

         drive.OnProgress -= BurnProgress;
      }
      catch (Exception ex)
      {
         MessageBox.Show("Test Failed: " + ex.Message);
      }
   }

   public void BurnProgress(Object sender, EventArgs evt)
   {
      System.Diagnostics.Debug.WriteLine(evt.ToString());
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Remarks

The media in the drive should be of a type recordable or rewriteable to allow this operation. To retrieve the type of the media in the drive, check the MediaWriterDrive.CurrentDiscType property. If an error occurs a Win32Exception will be thrown. Please Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also

Leadtools.MediaWriter requires a Document or Medical or Multimedia toolkit license and unlock key. For more information, refer to: Imaging Pro/Document/Medical/Multimedia features