In This Topic ▼

Available Property

Summary

Indicates whether the target format is available.

Syntax

C++/CLI

public bool Available {get;}

public:  
   property bool Available 
   { 
      bool get() 
   }

Property Value

true indicates the target format is available; otherwise, false.

Remarks

Target format availability depends on the media sinks and multiplexers that are registered in your system. Microsoft Media Foundation components vary with the operating system version. Use this property to determine if the required components are installed.

Example

using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(false); 
 
public void TargetFormatsExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set the video capture device, use your capture device name here 
      if (capturectrl.VideoDevices["USB"] == null) 
         throw new Exception("No USB video device available"); 
 
      capturectrl.VideoDevices["USB"].Selected = true; 
 
      // set the audio capture device, use your capture device name here 
      if (capturectrl.AudioDevices["USB"] == null) 
         throw new Exception("No USB audio device available"); 
 
      capturectrl.AudioDevices["USB"].Selected = true; 
 
      // select the MP4 target format 
      capturectrl.TargetFormats[TargetFormatType.MP4].Selected = true; 
 
      // get the current selected format 
      int n = capturectrl.TargetFormats.Selection; 
 
      // loop through the target formats and set a different one 
      foreach (TargetFormat t in capturectrl.TargetFormats) 
      { 
         // get the format properties 
         string name = t.Name; 
         StreamFormatType sft = t.Streams; 
         bool available = t.Available; 
 
         // if we found the WMV format 
         if (name == "WMV") 
         { 
            // if it is available then select it 
            if (available) 
            { 
               t.Selected = true; 
            } 
            // exit loop 
            break; 
         } 
      } 
 
      // check it directly 
      TargetFormatType tft = capturectrl.TargetFormat; 
 
      // set the result to what we expect 
      _result = (tft != TargetFormatType.MP4 && n != capturectrl.TargetFormats.Selection); 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
 
   // we'll loop on the state and pump messages for this example. 
   // but you should not need to if running from a Windows Forms application. 
   while (capturectrl.State == CaptureState.Running) 
      Application.DoEvents(); 
}

Requirements

Target Platforms

Reference

TargetFormat Class

TargetFormat Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.MediaFoundation Assembly

Introduction

Getting Started

Namespaces

Leadtools.MediaFoundation Namespace

Leadtools.MediaFoundation.Common Namespace

Assemblies