In This Topic ▼

GetPreferredMediaSourceHandler Method

Summary

Retrieves the preferred media source handler's GUID set using SetPreferredMediaSourceHandler.

Syntax

C++

public virtual string GetPreferredMediaSourceHandler( 
   PreferredMediaSourceHandler MediaSourceHandlerType 
)

Public Overridable Function GetPreferredMediaSourceHandler( _ 
   ByVal MediaSourceHandlerType As PreferredMediaSourceHandler _ 
) As String

public: 
virtual String^ GetPreferredMediaSourceHandler(  
   PreferredMediaSourceHandler MediaSourceHandlerType 
)

Parameters

MediaSourceHandlerType
A PreferredMediaSourceHandler enumeration value specifying the desired media source handler type

Return Value

A string containing a media source handler's GUID.

Remarks

This method can be used to determine whether a preferred media source handler has been set by SetPreferredMediaSourceHandler. It will return NULL (if no preferred media source handler has been set) or a GUID indicating the preferred media source handler. This GUID uniquely identifies the media source handler. Every media format has one or registered media source handlers responsible of creating a media source for this media type.

For example, the GUID for the LEAD MPEG2 Transport Media Source Handler is: EFE626C3-0A2C-49FA-8A01-3768B559B6DA

A list of display names for common media source handlers can be found in Constants.PreferredMediaSourceHandlers.

Please see SetPreferredMediaSourceHandler for more information on media source handler display names.

Example

using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
public bool _result = false; 
public PlayCtrlForm _form = new PlayCtrlForm(); 
 
public void PlayerPreferredMediaSourceHandlersExample() 
{ 
   PlayCtrl playctrl = _form.PlayCtrl; 
 
   try 
   { 
      // set the preferred ISO(MP4) media source handler to the LEAD default (which is the LEAD ISO Media Source handler) 
      playctrl.SetPreferredMediaSourceHandler(PreferredMediaSourceHandler.ISO, Constants.PreferredMediaSourceHandlers.LEADDefault); 
 
      // the default ISO(MP4) media source handler should be the LEAD ISO(MP4) media source handler now 
      _result = (string.Compare(playctrl.GetPreferredMediaSourceHandler(PreferredMediaSourceHandler.ISO), 
                 Constants.PreferredMediaSourceHandlers.ISO, true) == 0); 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
}

Imports Leadtools 
Imports Leadtools.MediaFoundation 
Imports LeadtoolsMediaFoundationExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As PlayCtrlForm = New PlayCtrlForm() 
 
Public Sub PlayerPreferredMediaSourceHandlersExample() 
   Try 
      ' reference the forms play control 
      Dim playctrl As PlayCtrl = _form.PlayCtrl 
 
      ' set the preferred ISO(MP4) media source handler to the LEAD default (which is the LEAD ISO Media Source handler) 
      playctrl.SetPreferredMediaSourceHandler(PreferredMediaSourceHandler.ISO, 
                                  Leadtools.MediaFoundation.Constants.PreferredMediaSourceHandlers.LEADDefault) 
 
      ' the default ISO(MP4) media source handler should be the LEAD ISO(MP4) media source handler now 
      _result = (String.Compare(playctrl.GetPreferredMediaSourceHandler(PreferredMediaSourceHandler.ISO), 
                                Leadtools.MediaFoundation.Constants.PreferredMediaSourceHandlers.ISO, True) = 0) 
   Catch e1 As Exception 
      _result = False 
   End Try 
End Sub

Requirements

Target Platforms

Reference

PlayCtrl Class

PlayCtrl Members

SetPreferredMediaSourceHandler Method

Download our FREE evaluation

Help Version 21.0.2021.7.2

Leadtools.MediaFoundation Assembly

Introduction

Getting Started

Namespaces

Leadtools.MediaFoundation Namespace

Leadtools.MediaFoundation.Common Namespace

Assemblies