upnp_control.h

AMLOGIC DPF source code

/*******************************************************************
 * 
 *  Copyright C 2005 by Amlogic, Inc. All Rights Reserved.
 *
 *  Description: 
 *
 *  Author: Eric Knudstrup
 *  Created: Wed Jul 13 15:52:29 2005
 *
 *******************************************************************/

#ifndef UPNP_CONTROL_H
#define UPNP_CONTROL_H

typedef struct upnp_control_s UPnPControl_t;
typedef void (*UPnPControlHandler_t) (HTTPTcpConnection_t *conn, 
                                      HTTPInputMessage_t *message, 
                                      void *context, char *data);

/*;emacs generated header for file upnp_control.c. Global function declarations only. */
/**
 * Initialize UPnP MediaRenderer subsystem.
 * Requires that the network interface has been initialized.
 */
extern int
upnp_control_init(char *friendlyName,
                  char *manufacturer,
                  char *manufacturerURL,
                  char *modelDescription,
                  char *modelName,
                  char *modelNumber,
                  char *modelURL,
                  char *serialNumber,
                  char *uuid);

extern void
upnp_delete_control_handler(UPnPControl_t *control);

/**
 * Register a handler for a \a path with the UPnP http server.
 * 
 * @param handler A \a UPnPControlHandler_t callback function.
 * @param path Path to resource ("/upnp/blah.xml");
 * @param context Upper application layer context.
 *
 * @returns A \a UPnPControl_t reference, or NULL if allocation failed.
 */
extern UPnPControl_t *
upnp_register_control_handler(UPnPControlHandler_t handler, const char *path, 
 void *context);

extern void *
upnp_control_context(UPnPControl_t *control);

extern UPnPControl_t *
upnp_control_find(const char *resource_url);


/**
 * Retrieve the IP address and TCP port for the
 * UPnP control listener connection.
 * @returns 0 if successful and the subsystem has
 * been properly initialized, non-zero otherwise.
 */
extern int
upnp_control_address(struct ip_addr *address, unsigned short *port);

/*;end emacs generated header for file upnp_control.c. Global function declarations only. */

#endif