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



discProps
A disc properties object created by MediaWriterDrive.CreateDisc

The CreateISO 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
Creates an .ISO image file on the selected folder path.

Syntax

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

Parameters

discProps
A disc properties object created by MediaWriterDrive.CreateDisc

Example

Visual BasicCopy Code
Public Sub CreateISOExample()
      Dim writer As MediaWriter = New MediaWriter()
      Dim drives As List(Of MediaWriterDrive) = writer.Drives
      Try
         Dim drive As MediaWriterDrive = drives(1)
         Dim disc As MediaWriterDisc = drive.CreateDisc()

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

         drive.AutoEject = True
         AddHandler drive.OnProgress, AddressOf ISOProgress

         ' CreateISO method starts
         drive.CreateISO(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 ISOProgress

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

   Public Sub ISOProgress(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 CreateISOExample()
   {
      MediaWriter writer = new MediaWriter();
      List<MediaWriterDrive> drives = writer.Drives;
      try
      {
         MediaWriterDrive drive = drives[1];
         MediaWriterDisc disc = drive.CreateDisc();

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

         drive.AutoEject = true;
         drive.OnProgress += ISOProgress;

         // CreateISO method starts
         drive.CreateISO(disc);

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

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

   public void ISOProgress(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

This method creates an .ISO image file on the hard disk. If an output disc of NONE is selected and OutputFile is set, this method will write the selected input file(s) or folder(s) to the specified fully qualified .ISO file. 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