Эх сурвалжийг харах

[media] media-entity.h: document the remaining functions

There are two ancillary functions that are missing comments.

While those are used only internally at media-entity.c,
document them, for completeness.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Mauro Carvalho Chehab 9 жил өмнө
parent
commit
630c0e80c9

+ 11 - 0
include/media/media-entity.h

@@ -301,11 +301,22 @@ static inline enum media_gobj_type media_type(struct media_gobj *gobj)
 	return gobj->id >> MEDIA_BITS_PER_ID;
 	return gobj->id >> MEDIA_BITS_PER_ID;
 }
 }
 
 
+/**
+ * media_id() - return the media object ID
+ *
+ * @gobj:	pointer to the media graph object
+ */
 static inline u32 media_id(struct media_gobj *gobj)
 static inline u32 media_id(struct media_gobj *gobj)
 {
 {
 	return gobj->id & MEDIA_ID_MASK;
 	return gobj->id & MEDIA_ID_MASK;
 }
 }
 
 
+/**
+ * media_gobj_gen_id() - encapsulates type and ID on at the object ID
+ *
+ * @type:	object type as define at enum &media_gobj_type.
+ * @local_id:	next ID, from struct &media_device.@id.
+ */
 static inline u32 media_gobj_gen_id(enum media_gobj_type type, u64 local_id)
 static inline u32 media_gobj_gen_id(enum media_gobj_type type, u64 local_id)
 {
 {
 	u32 id;
 	u32 id;