Share via

IWMEncPluginInfo.Exclusive

  • Article
Windows Media Encoder SDK banner art

The Exclusive property retrieves a Boolean indicating whether the plug-in can be used more than once in an encoding session.

Syntax

Boolean = IWMEncPluginInfo.Exclusive

Parameters

This property takes no parameters.

Property Value

A Boolean that indicates whether the plug-in can be used more than once.

Remarks

This property is read-only. For some physical devices it may be necessary for Exclusive to return True. By default, it returns False.

Example Code

' Declare objects.
Dim Encoder As WMEncoder
Dim iPIndex  As Integer
Dim iRIndex As Integer
Dim sScheme As String
Dim sResource As String
Dim SrcPlugMgr As IWMEncSourcePluginInfoManager
Dim PlugInfo As IWMEncPluginInfo

' Create a WMEncoder object and retrieve an
' IWMEncSourcePluginInfoManager object from it.
Set Encoder = New WMEncoder
Set SrcPlugMgr = Encoder.SourcePluginInfoManager

' Loop through the source plug-ins. Call the Item method on each
' plug-in to retrieve an IWMEncPluginInfo object. Use the
' SchemeType property to retrieve a string containing the scheme
' type of the plug-in. If the scheme type is "DEVICE" and if the
' plug-in supports resources, call the Item method to retrieve a
' string identifying the resource. If the resource indicates that
' the plug-in captures streams from the default video device,
' retrieve registry information about the plug-in.

' To capture streams from an attached device, you must choose a
' specific device plug-in.

Dim sCLSID As String
Dim sCopyright As String
Dim bExclusive As Boolean
Dim bHidden As Boolean
Dim pPropPage As Boolean
Dim sURL As String
Dim enumMediaType As WMENC_SOURCE_TYPE
Dim enumPluginType As WMENC_PLUGIN_TYPE
Dim sName As String

For iPIndex  = 0 To SrcPlugMgr.Count - 1
    Set PlugInfo = SrcPlugMgr.Item(iPIndex )
    sScheme = PlugInfo.SchemeType
    If sScheme = "DEVICE" Then
        If PlugInfo.Resources = True Then
            For iRIndex = 0 To PlugInfo.Count - 1
                sResource = PlugInfo.Item(iRIndex)
                If sResource = "Default_Video_Device" Then
               
                    ' Retrieve the plug-in GUID.
                    sCLSID = PlugInfo.CLSID
                   
                    ' Retrieve the copyright information.
                    sCopyright = PlugInfo.Copyright
                   
                    ' Determine whether the plug-in can be used
                    ' more than once in a source group.
                    bExclusive = PlugInfo.Exclusive
                   
                    ' Determine whether the plug-in is hidden
                    ' from the UI.
                    bHidden = PlugInfo.Hidden
                   
                    ' Retrieve the URL, if any, of the Web site
                    ' containing information about the plug-in.
                    sURL = PlugInfo.InfoURL
                   
                    ' Retrieve the media types supported by the
                    ' plug-in. This is a bitwise OR of the
                    ' WMENC_SOURCE_TYPE enumeration type.
                    enumMediaType = PlugInfo.MediaType
                   
                    ' Retrieve the name of the plug-in.
                    sName = PlugInfo.Name
                   
                    ' Determine whether the plug-in is a source or
                    ' transform type.
                    enumPluginType = PlugInfo.PluginType
                   
                    ' Determine whether the plug-in supports
                    ' property pages.
                    bPropPage = PlugInfo.PropertyPage
                End If
            Next
        End If
    End If
Next

' Continue configuring the encoding session.

Requirements

Reference: Windows Media Encoder

Library: wmenc.exe

See Also