comparison libpurple/prpl.h @ 23868:1aa383ee5fc8

Fixed up media functions in prpl.c and prpl.h, adding more documentation and using PURPLE_PROTOCOL_PLUGIN_HAS_FUNC.

23867:4bc74deeb503

	 * @return The protocol's string hash table. The hash table should be
	 *         destroyed by the caller when it's no longer needed.
	 */
	GHashTable *(*get_account_text_table)(PurpleAccount *account);

	/** Initiate media with the given buddy */
	PurpleMedia  *(*initiate_media)(PurpleConnection *conn, const char *who, PurpleMediaStreamType type);

	gboolean (*can_do_media)(PurpleConnection *conn, const char *who, PurpleMediaStreamType type);
};

#define PURPLE_PROTOCOL_PLUGIN_HAS_FUNC(prpl, member) \
	(((G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < G_STRUCT_OFFSET(PurplePluginProtocolInfo, struct_size)) \
	  || (G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < prpl->struct_size)) && \

23868:1aa383ee5fc8

	 * @return The protocol's string hash table. The hash table should be
	 *         destroyed by the caller when it's no longer needed.
	 */
	GHashTable *(*get_account_text_table)(PurpleAccount *account);

	/**
	 * Initiate a media session with the given contact.
	 *
	 * @param conn The connection to initiate the media session on.
	 * @param who The remote user to initiate the session with.
	 * @param type The type of media session to initiate.
	 * @return The newly created media object.
	 */
	PurpleMedia  *(*initiate_media)(PurpleConnection *gc, const char *who,
					PurpleMediaStreamType type);

	/**
	 * Checks to see if the given contact supports the given type of media session.
	 *
	 * @param conn The connection the contact is on.
	 * @param who The remote user to check for media capability with.
	 * @param type The type of media session to check for.
	 * @return @c TRUE The contact supports the given media type, or @c FALSE otherwise.
	 */
	gboolean (*can_do_media)(PurpleConnection *gc, const char *who,
				 PurpleMediaStreamType type);
};

#define PURPLE_PROTOCOL_PLUGIN_HAS_FUNC(prpl, member) \
	(((G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < G_STRUCT_OFFSET(PurplePluginProtocolInfo, struct_size)) \
	  || (G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < prpl->struct_size)) && \