Media​Extension​Manager Media​Extension​Manager Media​Extension​Manager Class

Definition

Registers a media parser or codec.

public sealed class MediaExtensionManager : IMediaExtensionManager, IMediaExtensionManager2public sealed class MediaExtensionManager : IMediaExtensionManager, IMediaExtensionManager2Public NotInheritable Class MediaExtensionManager Implements IMediaExtensionManager, IMediaExtensionManager2
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Media extensions have the following limitations.

  • A plugin can override inbox media formats.
  • The registration is local to the application and does not affect other applications.
  • The registration persists for the lifetime of the MediaExtensionManager instance.

Constructors

MediaExtensionManager() MediaExtensionManager() MediaExtensionManager()

Creates a new MediaExtensionManager object that is used to register a media parser or codec.

public MediaExtensionManager()public MediaExtensionManager()Public Sub New()
Attributes

Methods

RegisterAudioDecoder(String, Guid, Guid) RegisterAudioDecoder(String, Guid, Guid) RegisterAudioDecoder(String, Guid, Guid)

Registers an audio decoder for the specified input and output media types.

public void RegisterAudioDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)public void RegisterAudioDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)Public Function RegisterAudioDecoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the audio decoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the audio decoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the audio decoder.

Attributes

RegisterAudioDecoder(String, Guid, Guid, IPropertySet) RegisterAudioDecoder(String, Guid, Guid, IPropertySet) RegisterAudioDecoder(String, Guid, Guid, IPropertySet)

Registers an audio decoder for the specified input and output media types with an optional configuration parameter.

public void RegisterAudioDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)public void RegisterAudioDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)Public Function RegisterAudioDecoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the audio decoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the audio decoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the audio decoder.

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains the configuration properties to be passed to the audio decoder.

Attributes

RegisterAudioEncoder(String, Guid, Guid) RegisterAudioEncoder(String, Guid, Guid) RegisterAudioEncoder(String, Guid, Guid)

Registers an audio encoder for the specified input and output media types.

public void RegisterAudioEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)public void RegisterAudioEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)Public Function RegisterAudioEncoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the audio encoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the audio encoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the audio encoder.

Attributes

RegisterAudioEncoder(String, Guid, Guid, IPropertySet) RegisterAudioEncoder(String, Guid, Guid, IPropertySet) RegisterAudioEncoder(String, Guid, Guid, IPropertySet)

Registers an audio encoder for the specified input and output media types with an optional configuration parameter.

public void RegisterAudioEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)public void RegisterAudioEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)Public Function RegisterAudioEncoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the audio encoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the audio encoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the audio encoder.

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains the configuration properties to be passed to the audio encoder.

Attributes

RegisterByteStreamHandler(String, String, String) RegisterByteStreamHandler(String, String, String) RegisterByteStreamHandler(String, String, String)

Registers a byte-stream handler by file name extension and MIME type.

public void RegisterByteStreamHandler(String activatableClassId, String fileExtension, String mimeType)public void RegisterByteStreamHandler(String activatableClassId, String fileExtension, String mimeType)Public Function RegisterByteStreamHandler(activatableClassId As String, fileExtension As String, mimeType As String) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the byte-stream handler. The runtime class must implement the IMediaExtension interface.

fileExtension
System.String System.String System.String

The file name extension that is registered for this byte-stream handler.

mimeType
System.String System.String System.String

The MIME type that is registered for this byte-stream handler.

Attributes

RegisterByteStreamHandler(String, String, String, IPropertySet) RegisterByteStreamHandler(String, String, String, IPropertySet) RegisterByteStreamHandler(String, String, String, IPropertySet)

Registers a byte-stream handler by file name extension and MIME type, with an optional configuration parameter.

public void RegisterByteStreamHandler(String activatableClassId, String fileExtension, String mimeType, IPropertySet configuration)public void RegisterByteStreamHandler(String activatableClassId, String fileExtension, String mimeType, IPropertySet configuration)Public Function RegisterByteStreamHandler(activatableClassId As String, fileExtension As String, mimeType As String, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the byte-stream handler. The runtime class must implement the IMediaExtension interface.

fileExtension
System.String System.String System.String

The file name extension that is registered for this byte-stream handler.

mimeType
System.String System.String System.String

The MIME type that is registered for this byte-stream handler.

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains configuration properties for the byte-stream handler.

Attributes

RegisterMediaExtensionForAppService(IMediaExtension, AppServiceConnection) RegisterMediaExtensionForAppService(IMediaExtension, AppServiceConnection) RegisterMediaExtensionForAppService(IMediaExtension, AppServiceConnection)

Registers a media extension that provides a background task that decodes media.

public void RegisterMediaExtensionForAppService(IMediaExtension extension, AppServiceConnection connection)public void RegisterMediaExtensionForAppService(IMediaExtension extension, AppServiceConnection connection)Public Function RegisterMediaExtensionForAppService(extension As IMediaExtension, connection As AppServiceConnection) As void
Parameters
extension
IMediaExtension IMediaExtension IMediaExtension

An object that implements IMediaExtension.

connection
AppServiceConnection AppServiceConnection AppServiceConnection

An AppServiceConnection object that represents an endpoint connection for an app service.

Attributes
Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Remarks

Call this method from within the Run method of a Windows Runtime Component that exposes your media extension.

Get an instance of AppServiceConnection by casting the TriggerDetails property of the IBackgroundTaskInstance passed into the Run method to an AppServiceTriggerDetails object and then accessing the AppServiceConnection property.

In order for your background task to receive an AppServiceTriggerDetails object, you must register it as an app service in you app manifest file. For more information, see Create and consume an app service.

RegisterSchemeHandler(String, String) RegisterSchemeHandler(String, String) RegisterSchemeHandler(String, String)

Registers a scheme handler for the specified URL scheme.

public void RegisterSchemeHandler(String activatableClassId, String scheme)public void RegisterSchemeHandler(String activatableClassId, String scheme)Public Function RegisterSchemeHandler(activatableClassId As String, scheme As String) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the scheme handler. The runtime class must implement the IMediaExtension interface.

scheme
System.String System.String System.String

The URL scheme that will be recognized to invoke the scheme handler. For example, "myscheme://".

Attributes

RegisterSchemeHandler(String, String, IPropertySet) RegisterSchemeHandler(String, String, IPropertySet) RegisterSchemeHandler(String, String, IPropertySet)

Registers a scheme handler for the specified URL scheme with an optional configuration parameter.

public void RegisterSchemeHandler(String activatableClassId, String scheme, IPropertySet configuration)public void RegisterSchemeHandler(String activatableClassId, String scheme, IPropertySet configuration)Public Function RegisterSchemeHandler(activatableClassId As String, scheme As String, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the scheme handler. The runtime class must implement the IMediaExtension interface.

scheme
System.String System.String System.String

The URL scheme that will be recognized to invoke the scheme handler. For example, "myscheme://".

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains configuration properties for the scheme handler.

Attributes

RegisterVideoDecoder(String, Guid, Guid) RegisterVideoDecoder(String, Guid, Guid) RegisterVideoDecoder(String, Guid, Guid)

Registers an video decoder for the specified input and output media types.

public void RegisterVideoDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)public void RegisterVideoDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)Public Function RegisterVideoDecoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the video decoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the video decoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the video decoder.

Attributes

RegisterVideoDecoder(String, Guid, Guid, IPropertySet) RegisterVideoDecoder(String, Guid, Guid, IPropertySet) RegisterVideoDecoder(String, Guid, Guid, IPropertySet)

Registers a video decoder for the specified input and output media types with an optional configuration parameter.

public void RegisterVideoDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)public void RegisterVideoDecoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)Public Function RegisterVideoDecoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the video decoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the video decoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the video decoder.

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains the configuration properties to be passed to the video decoder.

Attributes

RegisterVideoEncoder(String, Guid, Guid) RegisterVideoEncoder(String, Guid, Guid) RegisterVideoEncoder(String, Guid, Guid)

Registers a video encoder for the specified input and output media types.

public void RegisterVideoEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)public void RegisterVideoEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype)Public Function RegisterVideoEncoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the video encoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the video encoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the video encoder.

Attributes

RegisterVideoEncoder(String, Guid, Guid, IPropertySet) RegisterVideoEncoder(String, Guid, Guid, IPropertySet) RegisterVideoEncoder(String, Guid, Guid, IPropertySet)

Registers a video encoder for the specified input and output media types with an optional configuration parameter.

public void RegisterVideoEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)public void RegisterVideoEncoder(String activatableClassId, Guid inputSubtype, Guid outputSubtype, IPropertySet configuration)Public Function RegisterVideoEncoder(activatableClassId As String, inputSubtype As Guid, outputSubtype As Guid, configuration As IPropertySet) As void
Parameters
activatableClassId
System.String System.String System.String

The class identifier of the activatable runtime class of the video encoder. The runtime class must implement the IMediaExtension interface.

inputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that the video encoder accepts as input.

outputSubtype
System.Guid System.Guid System.Guid

The guid identifier of the media type that is output by the video encoder.

configuration
IPropertySet IPropertySet IPropertySet

An optional parameter that contains the configuration properties to be passed to the video encoder.

Attributes

See Also