openkylin
/
linux
mirror of https://gitee.com/openkylin/linux.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity

[media] media-device.h: document the last functions 

Add kernel-doc documentation for media_device_get_devres and
media_device_find_devres.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
This commit is contained in:
Mauro Carvalho Chehab 2015-12-13 08:36:58 -02:00
parent 60266185d7
commit b6e4ca8129
2 changed files with 22 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
drivers/media/media-device.c
View File

@ -689,10 +689,6 @@ static void media_device_release_devres(struct device *dev, void *res)
{ {
} }
/*
* media_device_get_devres() - get media device as device resource
* creates if one doesn't exist
*/
struct media_device *media_device_get_devres(struct device *dev) struct media_device *media_device_get_devres(struct device *dev)
{ {
struct media_device *mdev; struct media_device *mdev;
@ -709,9 +705,6 @@ struct media_device *media_device_get_devres(struct device *dev)
} }
EXPORT_SYMBOL_GPL(media_device_get_devres); EXPORT_SYMBOL_GPL(media_device_get_devres);
/*
* media_device_find_devres() - find media device as device resource
*/
struct media_device *media_device_find_devres(struct device *dev) struct media_device *media_device_find_devres(struct device *dev)
{ {
return devres_find(dev, media_device_release_devres, NULL, NULL); return devres_find(dev, media_device_release_devres, NULL, NULL);

22
include/media/media-device.h
View File

@ -449,7 +449,29 @@ int __must_check media_device_register_entity(struct media_device *mdev,
* the driver if required. * the driver if required.
*/ */
void media_device_unregister_entity(struct media_entity *entity); void media_device_unregister_entity(struct media_entity *entity);
/**
* media_device_get_devres() - get media device as device resource
* creates if one doesn't exist
*
* @dev: pointer to struct &device.
*
* Sometimes, the media controller &media_device needs to be shared by more
* than one driver. This function adds support for that, by dynamically
* allocating the &media_device and allowing it to be obtained from the
* struct &device associated with the common device where all sub-device
* components belong. So, for example, on an USB device with multiple
* interfaces, each interface may be handled by a separate per-interface
* drivers. While each interface have its own &device, they all share a
* common &device associated with the hole USB device.
*/
struct media_device *media_device_get_devres(struct device *dev); struct media_device *media_device_get_devres(struct device *dev);
/**
* media_device_find_devres() - find media device as device resource
*
* @dev: pointer to struct &device.
*/
struct media_device *media_device_find_devres(struct device *dev); struct media_device *media_device_find_devres(struct device *dev);
/* Iterate over all entities. */ /* Iterate over all entities. */