GUPnP.ControlPoint
Description: Reference for GUPnP.ControlPoint

### Class

# GUPnPControlPoint

#### Description [src]

    class GUPnP.ControlPoint : GSSDP.ResourceBrowser {
      parent_instance: GSSDPResourceBrowser
    }

Network resource discovery.

`GUPnPControlPoint` handles device and service discovery. After creating a control point and activating it using `gssdp_resource_browser_set_active()`, the `GUPnPControlPoint::device-proxy-available`, `GUPnPControlPoint::service-proxy-available`, `GUPnPControlPoint::device-proxy-unavailable` and `GUPnPControlPoint::service-proxy-unavailable` signals will be emitted whenever the availability of a device or service matching the specified discovery target changes.

#### Ancestors

- GSSDPResourceBrowser
- GObject

#### Constructors

###### gupnp_control_point_new

Create a new `GUPnPControlPoint` with the specified `context` and `target`.

###### gupnp_control_point_new_full

Create a new `GUPnPControlPoint` with the specified `context`, `factory` and `target`.

#### Instance methods

###### gupnp_control_point_get_context

Get the `GUPnPControlPoint` associated with `control_point`.

Deprecated since: 1.4.0

###### gupnp_control_point_get_resource_factory

Get the `GUPnPResourceFactory` used by the `control_point`. If none was set during construction by calling `gupnp_control_point_new_full()`, equivalent to calling `gupnp_resource_factory_get_default()`

###### gupnp_control_point_list_device_proxies

Get the list of `GUPnPDeviceProxy` objects the control point currently assumes to be active.

###### gupnp_control_point_list_service_proxies

Get the list of discovered `GUPnPServiceProxy` objects the control point currently assumes to be active.

##### Methods inherited from GSSDPResourceBrowser (8)

###### gssdp_resource_browser_get_active

Get whether the browser is currently active.

###### gssdp_resource_browser_get_client

Get the GSSDPClient this resource browser is using for SSDP.

###### gssdp_resource_browser_get_mx

Get the current MX value.

###### gssdp_resource_browser_get_target

Get the current browse target.

###### gssdp_resource_browser_rescan

Begins discovery if `resource_browser` is active and no discovery is performed. Otherwise does nothing.

###### gssdp_resource_browser_set_active

(De)activates `resource_browser`.

###### gssdp_resource_browser_set_mx

Sets the used MX value of `resource_browser` to `mx`.

###### gssdp_resource_browser_set_target

Sets the browser target of `resource_browser` to `target`.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### GUPnP.ControlPoint:resource-factory

The resource factory to use. Set to NULL for default factory.

##### Properties inherited from GSSDPResourceBrowser (4)

###### GSSDP.ResourceBrowser:active

Whether this browser is active or not.

###### GSSDP.ResourceBrowser:client

The `GSSDPClient` to use for listening to SSDP messages.

###### GSSDP.ResourceBrowser:mx

The maximum number of seconds in which to request other parties to respond.

###### GSSDP.ResourceBrowser:target

The discovery target this resource browser is looking for.

#### Signals

###### GUPnP.ControlPoint::device-proxy-available

The ::device-proxy-available signal is emitted whenever a new device has become available.

###### GUPnP.ControlPoint::device-proxy-unavailable

The ::device-proxy-unavailable signal is emitted whenever a device is not available any more.

###### GUPnP.ControlPoint::service-proxy-available

The ::service-proxy-available signal is emitted whenever a new service has become available.

###### GUPnP.ControlPoint::service-proxy-unavailable

The ::service-proxy-unavailable signal is emitted whenever a service is not available any more.

##### Signals inherited from GSSDPResourceBrowser (3)

###### GSSDP.ResourceBrowser::resource-available

The ::resource-available signal is emitted whenever a new resource has become available.

###### GSSDP.ResourceBrowser::resource-unavailable

The ::resource-unavailable signal is emitted whenever a resource is not available any more.

###### GSSDP.ResourceBrowser::resource-update

The ::resource-update signal is emitted whenever an UPnP 1.1 device is about to change it’s BOOTID.

Available since: 1.2.0

##### Signals inherited from GObject (1)

###### GObject.Object::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct GUPnPControlPointClass {
      GSSDPResourceBrowserClass parent_class;
      void (* device_proxy_available) (
        GUPnPControlPoint* control_point,
        GUPnPDeviceProxy* proxy
      );
      void (* device_proxy_unavailable) (
        GUPnPControlPoint* control_point,
        GUPnPDeviceProxy* proxy
      );
      void (* service_proxy_available) (
        GUPnPControlPoint* control_point,
        GUPnPServiceProxy* proxy
      );
      void (* service_proxy_unavailable) (
        GUPnPControlPoint* control_point,
        GUPnPServiceProxy* proxy
      );
      void (* _gupnp_reserved1) (
    void
      );
      void (* _gupnp_reserved2) (
    void
      );
      void (* _gupnp_reserved3) (
    void
      );

    }

###### Class members

`parent_class` |
    GSSDPResourceBrowserClass
| No description available.
`device_proxy_available` |
    void (* device_proxy_available) (
        GUPnPControlPoint* control_point,
        GUPnPDeviceProxy* proxy
      )
| No description available.
`device_proxy_unavailable` |
    void (* device_proxy_unavailable) (
        GUPnPControlPoint* control_point,
        GUPnPDeviceProxy* proxy
      )
| No description available.
`service_proxy_available` |
    void (* service_proxy_available) (
        GUPnPControlPoint* control_point,
        GUPnPServiceProxy* proxy
      )
| No description available.
`service_proxy_unavailable` |
    void (* service_proxy_unavailable) (
        GUPnPControlPoint* control_point,
        GUPnPServiceProxy* proxy
      )
| No description available.
`_gupnp_reserved1` |
    void (* _gupnp_reserved1) (
    void
      )
| No description available.
`_gupnp_reserved2` |
    void (* _gupnp_reserved2) (
    void
      )
| No description available.
`_gupnp_reserved3` |
    void (* _gupnp_reserved3) (
    void
      )
| No description available.

#### Virtual methods

###### GUPnP.ControlPointClass.device_proxy_available

No description available.

###### GUPnP.ControlPointClass.device_proxy_unavailable

No description available.

###### GUPnP.ControlPointClass.service_proxy_available

No description available.

###### GUPnP.ControlPointClass.service_proxy_unavailable

No description available.