forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
63 lines
2.2 KiB
63 lines
2.2 KiB
/* SPDX-License-Identifier: GPL-2.0+ */ |
|
/* |
|
* media-dev-allocator.h - Media Controller Device Allocator API |
|
* |
|
* Copyright (c) 2019 Shuah Khan <[email protected]> |
|
* |
|
* Credits: Suggested by Laurent Pinchart <[email protected]> |
|
*/ |
|
|
|
/* |
|
* This file adds a global ref-counted Media Controller Device Instance API. |
|
* A system wide global media device list is managed and each media device |
|
* includes a kref count. The last put on the media device releases the media |
|
* device instance. |
|
*/ |
|
|
|
#ifndef _MEDIA_DEV_ALLOCATOR_H |
|
#define _MEDIA_DEV_ALLOCATOR_H |
|
|
|
struct usb_device; |
|
|
|
#if defined(CONFIG_MEDIA_CONTROLLER) && IS_ENABLED(CONFIG_USB) |
|
/** |
|
* media_device_usb_allocate() - Allocate and return struct &media device |
|
* |
|
* @udev: struct &usb_device pointer |
|
* @module_name: should be filled with %KBUILD_MODNAME |
|
* @owner: struct module pointer %THIS_MODULE for the driver. |
|
* %THIS_MODULE is null for a built-in driver. |
|
* It is safe even when %THIS_MODULE is null. |
|
* |
|
* This interface should be called to allocate a Media Device when multiple |
|
* drivers share usb_device and the media device. This interface allocates |
|
* &media_device structure and calls media_device_usb_init() to initialize |
|
* it. |
|
* |
|
*/ |
|
struct media_device *media_device_usb_allocate(struct usb_device *udev, |
|
const char *module_name, |
|
struct module *owner); |
|
/** |
|
* media_device_delete() - Release media device. Calls kref_put(). |
|
* |
|
* @mdev: struct &media_device pointer |
|
* @module_name: should be filled with %KBUILD_MODNAME |
|
* @owner: struct module pointer %THIS_MODULE for the driver. |
|
* %THIS_MODULE is null for a built-in driver. |
|
* It is safe even when %THIS_MODULE is null. |
|
* |
|
* This interface should be called to put Media Device Instance kref. |
|
*/ |
|
void media_device_delete(struct media_device *mdev, const char *module_name, |
|
struct module *owner); |
|
#else |
|
static inline struct media_device *media_device_usb_allocate( |
|
struct usb_device *udev, const char *module_name, |
|
struct module *owner) |
|
{ return NULL; } |
|
static inline void media_device_delete( |
|
struct media_device *mdev, const char *module_name, |
|
struct module *owner) { } |
|
#endif /* CONFIG_MEDIA_CONTROLLER && CONFIG_USB */ |
|
#endif /* _MEDIA_DEV_ALLOCATOR_H */
|
|
|