[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:
@@ -449,7 +449,29 @@ int __must_check media_device_register_entity(struct media_device *mdev,
|
||||
* the driver if required.
|
||||
*/
|
||||
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);
|
||||
|
||||
/**
|
||||
* 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);
|
||||
|
||||
/* Iterate over all entities. */
|
||||
|
Reference in New Issue
Block a user