←Select platform

BurnDisc Method

Summary

Performs actual burning of an .ISO image or selected folder path to the disc in the current drive.

Syntax

C++

public void BurnDisc( 
   MediaWriterDisc discProps 
)

Public Sub BurnDisc( _ 
   ByVal discProps As Leadtools.Mediawriter.MediaWriterDisc _ 
)

public: 
void BurnDisc(  
   Leadtools.Mediawriter.MediaWriterDisc^ discProps 
)

Parameters

discProps
A disc properties object created by MediaWriterDrive.CreateDisc

Remarks

The media in the drive should be recordable or rewritable 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.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.MediaWriter; 
 
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"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.MediaWriter 
 
<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

Requirements

Target Platforms

Reference

MediaWriterDrive Class

MediaWriterDrive Members

State property

Help Version 19.0.2017.10.27

Leadtools.MediaWriter Assembly

Introduction

Getting Started

Namespaces

Leadtools.MediaWriter Namespace

Assemblies