upnp_action.h

来自「AMLOGIC DPF source code」· C头文件 代码 · 共 68 行

/*******************************************************************
 * 
 *  Copyright C 2005 by Amlogic, Inc. All Rights Reserved.
 *
 *  Description: UPnP Action handling.
 *
 *  Author: Eric Knudstrup
 *  Created: Tue Sep 27 17:42:55 2005
 *
 *******************************************************************/

#ifndef UPNP_ACTION_H
#define UPNP_ACTION_H

typedef struct upnp_action_s UPnPAction_t;
typedef struct upnp_var_query_s UPnPVarQuery_t;

typedef int (*UPnPActionFunc_t) (void *in_data,
                                 void *out_data,
                                 char **errorDescription);

extern const char action_response_header[];

typedef enum {
    UPNP_MARSHALL_STRING, /**< It's a string */
    UPNP_MARSHALL_INT     /**< It's an integer */
} UPnPMarshallType_t;

typedef struct {
    int offset;              /**< Offset into the passed structure for this argument */
    UPnPMarshallType_t type; /**< Either UPNP_MARSHALL_STRING or UPNP_MARSHALL_INT */
    char *name;              /**< Name of the field */
} UPnPMarshallArgument_t;

typedef struct {
    void *marshall_structure; /**< Application's structure */
    int arg_count;            /**< Argument count */
    UPnPMarshallArgument_t *arguments; /**< List of arguments */
} UPnPMarshallTemplate_t;

/*;emacs generated header for file upnp_action.c. Global function declarations only. */
/**
 * Add an action handler for a service.
 * 
 * @param action_url URL for a service's action.
 * @param action_name Action name ("SetAVTransportURI").
 * @param action_func Callback function for this URL.
 * @param in_args Template for input arguments.
 * @param out_args Template for output arguments.
 * @returns a \a UPnPAction_t structure, or NULL on failure
 */
extern UPnPAction_t *
upnp_add_action( const char *action_url, char *action_name, 
 UPnPActionFunc_t action_func,
 UPnPMarshallTemplate_t *in_args,
 UPnPMarshallTemplate_t *out_args);

extern UPnPAction_t *
upnp_find_action_by_url(const char *action_url, const char *action);

extern UPnPAction_t *
upnp_find_action(list_t *action_list, const char *action_string);


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

#endif