upnp_media_directory.h

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

/*******************************************************************
 * 
 *  Copyright C 2005 by Amlogic, Inc. All Rights Reserved.
 *
 *  Description: 
 *
 *  Author: Eric Knudstrup
 *  Created: Mon Aug  1 16:13:45 2005
 *
 *******************************************************************/

#ifndef UPNP_MEDIA_DIRECTORY_H
#define UPNP_MEDIA_DIRECTORY_H

typedef void (*cds_relay_cb_t)(HTTPTcpConnection_t *client, HTTPInputMessage_t *message, char* xml_buffer);
/**
 * UPnP Content Directory Service connection
 */
typedef struct cds_con_s UPnPCDSConnection_t;

/*;emacs generated header for file upnp_media_directory.c. Global function declarations only. */
/** 
 * Destroy a UPnP Content Directory object including its siblings
 * and children.
 */
extern void
upnp_cd_destroy(UPnPMediaObject_t *object);

extern void
delete_cds_connection(UPnPCDSConnection_t *cds);

/**
 * Stop any pending Content Directory Service requests.
 */
extern void stop_cds_request(UPnPCDSConnection_t *cds);

/**
 * Create a UPnP Content Directory Service connection.
 */
extern UPnPCDSConnection_t *
create_cds_connection(UPnPDevice_t *device, UPnPMediaDirCb_t callback, void *arg);

/**
 * Given the media \a server and a container \a object,
 * check what objects are underneath.
 */
extern int
upnp_browse_children(UPnPCDSConnection_t *cds,
                     char *object_id,
                     char *filter,
                     unsigned int start_index,
                     unsigned int requested_count,
                     char *sort_criteria);

extern void
upnp_cds_unlock(UPnPCDSConnection_t *cds);

/* Lock the directory service connection descriptor.
 * Returns TRUE on success, FALSE if the descriptor is invalid.
 */
extern int
upnp_cds_lock(UPnPCDSConnection_t *cds);

extern void cds_relay(void* arg1,void* arg2, void* arg3, void* arg4);

extern void cds_set_cds_relay_cb(UPnPCDSConnection_t *cds,cds_relay_cb_t cds_relay_fun);

/**
 * Subscribe to variable event notifications for a ContentDirectory 
 * service.
 * @param[in] cds CDS connection to subscribe to.
 * @param[in] callback Application callback for notifications.
 * @param[in] context Application context for callback.
 * @returns 0 upon success, non-zero on failure.
 */
extern int
upnp_cds_subscribe(UPnPCDSConnection_t *cds,
                   UPnPNOTIFYHandler_t notify_handler, 
                   void *context);

/**
 * Unsubscribe from further UPnP ContentDirectory service 
 * notifications
 */
extern void
upnp_cds_unsubscribe(UPnPCDSConnection_t *cds);

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

#endif