:right-sidebar: True

DeviceProviderFactory
===================================================================

.. currentmodule:: gi.repository.Gst


.. versionadded:: 1.4




.. class:: DeviceProviderFactory(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gst.PluginFeature`, :class:`~gi.repository.Gst.Object`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`





:obj:`~gi.repository.Gst.DeviceProviderFactory` is used to create instances of device providers. A
GstDeviceProviderfactory can be added to a :obj:`~gi.repository.Gst.Plugin` as it is also a
:obj:`~gi.repository.Gst.PluginFeature`\.

Use the :func:`~gi.repository.Gst.DeviceProviderFactory.find` and
:func:`~gi.repository.Gst.DeviceProviderFactory.get` functions to create device
provider instances or use :func:`~gi.repository.Gst.DeviceProviderFactory.get_by_name` as a
convenient shortcut.




Methods
-------

.. rst-class:: interim-class

.. class:: DeviceProviderFactory
   :no-index:


   .. classmethod:: find() -> ~gi.repository.Gst.DeviceProviderFactory | None

      Search for an device provider factory of the given name. Refs the returned
      device provider factory; caller is responsible for unreffing.


      .. versionadded:: 1.4








   .. method:: get() -> ~gi.repository.Gst.DeviceProvider | None

      Returns the device provider of the type defined by the given device
      providerfactory.


      .. versionadded:: 1.4








   .. classmethod:: get_by_name() -> ~gi.repository.Gst.DeviceProvider | None

      Returns the device provider of the type defined by the given device
      provider factory.


      .. versionadded:: 1.4








   .. method:: get_device_provider_type() -> ~gobject.GType

      Get the :obj:`~gi.repository.GObject.Type` for device providers managed by this factory. The type can
      only be retrieved if the device provider factory is loaded, which can be
      assured with :func:`~gi.repository.Gst.PluginFeature.load`.


      .. versionadded:: 1.4








   .. method:: get_metadata(key: str) -> str | None

      Get the metadata on ``factory`` with ``key``\.


      .. versionadded:: 1.4





      :param key: a key




   .. method:: get_metadata_keys() -> list[str] | None

      Get the available keys for the metadata on ``factory``\.


      .. versionadded:: 1.4








   .. method:: has_classes(classes: str | None = None) -> bool

      Check if ``factory`` matches all of the given ``classes``


      .. versionadded:: 1.4





      :param classes: a "/" separate list of classes to match, only match
             if all classes are matched




   .. method:: has_classesv(classes: list[str] | None = None) -> bool

      Check if ``factory`` matches all of the given classes


      .. versionadded:: 1.4





      :param classes: a :const:`None` terminated array
           of classes to match, only match if all classes are matched




   .. classmethod:: list_get_device_providers() -> list[~gi.repository.Gst.DeviceProviderFactory]

      Get a list of factories with a rank greater or equal to ``minrank``\.
      The list of factories is returned by decreasing rank.


      .. versionadded:: 1.4