In This Topic ▼

GetPreferredMediaSourceHandler Method

Summary

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

Syntax

C++/CLI

public virtual string GetPreferredMediaSourceHandler( 
   PreferredMediaSourceHandler MediaSourceHandlerType 
)

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; 
   } 
}

Requirements

Target Platforms

Reference

PlayCtrl Class

PlayCtrl Members

SetPreferredMediaSourceHandler Method

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