SSDP Device Functions

Functions to manage SSDP for UPnP Devices. More...

int	AdvertiseAndReply (int AdFlag, UpnpDevice_Handle Hnd, enum SsdpSearchType SearchType, struct sockaddr *DestAddr, char *DeviceType, char *DeviceUDN, char *ServiceType, int Exp)
	Sends SSDP advertisements, replies and shutdown messages.
void	advertiseAndReplyThread (void *data)
	Wrapper function to reply the search request coming from the control point.
int	DeviceAdvertisement (char *DevType, int RootDev, char *Udn, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState)
	Creates the device advertisement request.
int	SendReply (struct sockaddr *DestAddr, char *DevType, int RootDev, char *Udn, char *Location, int Duration, int ByType, int PowerState, int SleepPeriod, int RegistrationState)
	Creates the reply packet and send it to the Control Point addesss.
int	DeviceReply (struct sockaddr *DestAddr, char *DevType, int RootDev, char *Udn, char *Location, int Duration, int PowerState, int SleepPeriod, int RegistrationState)
	Creates the reply packet and send it to the Control Point address.
int	ServiceAdvertisement (char *Udn, char *ServType, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState)
	Creates the advertisement packet and send it to the multicast channel.
int	ServiceReply (struct sockaddr *DestAddr, char *ServType, char *Udn, char *Location, int Duration, int PowerState, int SleepPeriod, int RegistrationState)
	Creates the advertisement packet and send it to the multicast channel.
int	ServiceShutdown (char *Udn, char *ServType, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState)
	Creates a HTTP service shutdown request packet and sends it to the multicast channel through RequestHandler.
int	DeviceShutdown (char *DevType, int RootDev, char *Udn, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState)
	Creates a HTTP device shutdown request packet and send it to the multicast channel through RequestHandler.

Detailed Description

Functions to manage SSDP for UPnP Devices.

Function Documentation

AdvertiseAndReply()

int AdvertiseAndReply	(	int	AdFlag,
		UpnpDevice_Handle	Hnd,
		enum SsdpSearchType	SearchType,
		struct sockaddr *	DestAddr,
		char *	DeviceType,
		char *	DeviceUDN,
		char *	ServiceType,
		int	Exp
	)

Sends SSDP advertisements, replies and shutdown messages.

Note

This function is only available when the Device option was enabled on compiling the library.

Returns

On success: UPNP_E_SUCCESS
There are several messages on stderr if DEBUG is enabled.
On error:

• UPNP_E_INVALID_HANDLE

Parameters

[in]	AdFlag	-1 = Send shutdown, 0 = send reply, 1 = Send Advertisement.
[in]	Hnd	Device handle.
[in]	SearchType	Search type for sending replies.
[in]	DestAddr	Destination address.
[in]	DeviceType	Device type.
[in]	DeviceUDN	Device UDN.
[in]	ServiceType	Service type.
[in]	Exp	Advertisement age.

Definition at line 967 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

advertiseAndReplyThread()

void advertiseAndReplyThread

(

void *

data

)

Wrapper function to reply the search request coming from the control point.

Parameters

[in]

data

Structure containing the search request.

Definition at line 1310 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

DeviceAdvertisement()

int DeviceAdvertisement	(	char *	DevType,
		int	RootDev,
		char *	Udn,
		char *	Location,
		int	Duration,
		int	AddressFamily,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates the device advertisement request.

Create it based on the input parameter, and send it to the multicast channel.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Definition at line 563 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

SendReply()

int SendReply	(	struct sockaddr *	DestAddr,
		char *	DevType,
		int	RootDev,
		char *	Udn,
		char *	Location,
		int	Duration,
		int	ByType,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates the reply packet and send it to the Control Point addesss.

Creates the reply packet based on the input parameter, and send it to the Control Point addesss given in its input parameter DestAddr.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Parameters

[in]	DestAddr	destination IP address.
[in]	DevType	Device type.
[in]	RootDev	1 means root device 0 means embedded device.
[in]	Udn	Device UDN.
[in]	Location	Location of Device description document.
[in]	Duration	Life time of this device.
[in]	ByType
[in]	PowerState	PowerState as defined by UPnP Low Power.
[in]	SleepPeriod	SleepPeriod as defined by UPnP Low Power.
[in]	RegistrationState	RegistrationState as defined by UPnP Low Power.

Definition at line 644 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

DeviceReply()

int DeviceReply	(	struct sockaddr *	DestAddr,
		char *	DevType,
		int	RootDev,
		char *	Udn,
		char *	Location,
		int	Duration,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates the reply packet and send it to the Control Point address.

Creates the reply packet based on the input parameter, and send it to the Control Point address given in its input parameter DestAddr.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_OUTOF_SOCKET
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Parameters

[in]	DestAddr	destination IP address.
[in]	DevType	Device type.
[in]	RootDev	1 means root device 0 means embedded device.
[in]	Udn	Device UDN.
[in]	Location	Location of Device description document.
[in]	Duration	Life time of this device.
[in]	PowerState	PowerState as defined by UPnP Low Power.
[in]	SleepPeriod	SleepPeriod as defined by UPnP Low Power.
[in]	RegistrationState	RegistrationState as defined by UPnP Low Power.

Definition at line 702 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ServiceAdvertisement()

int ServiceAdvertisement	(	char *	Udn,
		char *	ServType,
		char *	Location,
		int	Duration,
		int	AddressFamily,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates the advertisement packet and send it to the multicast channel.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_OUTOF_SOCKET
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Parameters

[in]	Udn	Device UDN.
[in]	ServType	Service Type.
[in]	Location	Location of Device description document.
[in]	Duration	Life time of this device.
[in]	AddressFamily	Device address family.
[in]	PowerState	PowerState as defined by UPnP Low Power.
[in]	SleepPeriod	SleepPeriod as defined by UPnP Low Power.
[in]	RegistrationState	RegistrationState as defined by UPnP Low Power.

Definition at line 762 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ServiceReply()

int ServiceReply	(	struct sockaddr *	DestAddr,
		char *	ServType,
		char *	Udn,
		char *	Location,
		int	Duration,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates the advertisement packet and send it to the multicast channel.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_OUTOF_SOCKET
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Parameters

[in]	DestAddr
[in]	ServType	Service Type.
[in]	Udn	Device UDN.
[in]	Location	Location of Device description document.
[in]	Duration	Life time of this device.
[in]	PowerState	PowerState as defined by UPnP Low Power.
[in]	SleepPeriod	SleepPeriod as defined by UPnP Low Power.
[in]	RegistrationState	RegistrationState as defined by UPnP Low Power.

Definition at line 813 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ServiceShutdown()

int ServiceShutdown	(	char *	Udn,
		char *	ServType,
		char *	Location,
		int	Duration,
		int	AddressFamily,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates a HTTP service shutdown request packet and sends it to the multicast channel through RequestHandler.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_OUTOF_SOCKET
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Definition at line 838 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

DeviceShutdown()

int DeviceShutdown	(	char *	DevType,
		int	RootDev,
		char *	Udn,
		char *	Location,
		int	Duration,
		int	AddressFamily,
		int	PowerState,
		int	SleepPeriod,
		int	RegistrationState
	)

Creates a HTTP device shutdown request packet and send it to the multicast channel through RequestHandler.

Returns

On success: UPNP_E_SUCCESS
On error:

• UPNP_E_OUTOF_MEMORY
• UPNP_E_INVALID_PARAM
• UPNP_E_OUTOF_SOCKET
• UPNP_E_NETWORK_ERROR
• UPNP_E_SOCKET_WRITE

Parameters

[in]	DevType	Device Type.
[in]	RootDev	1 means root device.
[in]	Udn	Device UDN.
[in]	Location	Location URL.
[in]	Duration	Device duration in sec.
[in]	AddressFamily	Device address family.
[in]	PowerState	PowerState as defined by UPnP Low Power.
[in]	SleepPeriod	SleepPeriod as defined by UPnP Low Power.
[in]	RegistrationState	RegistrationState as defined by UPnP Low Power.

Definition at line 889 of file ssdp_device.cpp.

Here is the call graph for this function:

Here is the caller graph for this function: