diff options
Diffstat (limited to 'include/media/v4l2-dev.h')
-rw-r--r-- | include/media/v4l2-dev.h | 51 |
1 files changed, 36 insertions, 15 deletions
diff --git a/include/media/v4l2-dev.h b/include/media/v4l2-dev.h index a0a6b41c5e09..0a88d1d17d30 100644 --- a/include/media/v4l2-dev.h +++ b/include/media/v4l2-dev.h | |||
@@ -25,6 +25,12 @@ | |||
25 | #define VFL_TYPE_MAX 4 | 25 | #define VFL_TYPE_MAX 4 |
26 | 26 | ||
27 | struct v4l2_ioctl_callbacks; | 27 | struct v4l2_ioctl_callbacks; |
28 | struct v4l2_device; | ||
29 | |||
30 | /* Flag to mark the video_device struct as unregistered. | ||
31 | Drivers can set this flag if they want to block all future | ||
32 | device access. It is set by video_unregister_device. */ | ||
33 | #define V4L2_FL_UNREGISTERED (0) | ||
28 | 34 | ||
29 | /* | 35 | /* |
30 | * Newer version of video_device, handled by videodev2.c | 36 | * Newer version of video_device, handled by videodev2.c |
@@ -39,15 +45,20 @@ struct video_device | |||
39 | 45 | ||
40 | /* sysfs */ | 46 | /* sysfs */ |
41 | struct device dev; /* v4l device */ | 47 | struct device dev; /* v4l device */ |
42 | struct cdev cdev; /* character device */ | 48 | struct cdev *cdev; /* character device */ |
43 | void (*cdev_release)(struct kobject *kobj); | 49 | |
50 | /* Set either parent or v4l2_dev if your driver uses v4l2_device */ | ||
44 | struct device *parent; /* device parent */ | 51 | struct device *parent; /* device parent */ |
52 | struct v4l2_device *v4l2_dev; /* v4l2_device parent */ | ||
45 | 53 | ||
46 | /* device info */ | 54 | /* device info */ |
47 | char name[32]; | 55 | char name[32]; |
48 | int vfl_type; | 56 | int vfl_type; |
57 | /* 'minor' is set to -1 if the registration failed */ | ||
49 | int minor; | 58 | int minor; |
50 | u16 num; | 59 | u16 num; |
60 | /* use bitops to set/clear/test flags */ | ||
61 | unsigned long flags; | ||
51 | /* attribute to differentiate multiple indices on one physical device */ | 62 | /* attribute to differentiate multiple indices on one physical device */ |
52 | int index; | 63 | int index; |
53 | 64 | ||
@@ -58,7 +69,7 @@ struct video_device | |||
58 | v4l2_std_id current_norm; /* Current tvnorm */ | 69 | v4l2_std_id current_norm; /* Current tvnorm */ |
59 | 70 | ||
60 | /* callbacks */ | 71 | /* callbacks */ |
61 | void (*release)(struct video_device *vfd); | 72 | void (*release)(struct video_device *vdev); |
62 | 73 | ||
63 | /* ioctl callbacks */ | 74 | /* ioctl callbacks */ |
64 | const struct v4l2_ioctl_ops *ioctl_ops; | 75 | const struct v4l2_ioctl_ops *ioctl_ops; |
@@ -67,36 +78,41 @@ struct video_device | |||
67 | /* dev to video-device */ | 78 | /* dev to video-device */ |
68 | #define to_video_device(cd) container_of(cd, struct video_device, dev) | 79 | #define to_video_device(cd) container_of(cd, struct video_device, dev) |
69 | 80 | ||
70 | /* Register and unregister devices. Note that if video_register_device fails, | 81 | /* Register video devices. Note that if video_register_device fails, |
71 | the release() callback of the video_device structure is *not* called, so | 82 | the release() callback of the video_device structure is *not* called, so |
72 | the caller is responsible for freeing any data. Usually that means that | 83 | the caller is responsible for freeing any data. Usually that means that |
73 | you call video_device_release() on failure. */ | 84 | you call video_device_release() on failure. |
74 | int __must_check video_register_device(struct video_device *vfd, int type, int nr); | 85 | |
75 | int __must_check video_register_device_index(struct video_device *vfd, | 86 | Also note that vdev->minor is set to -1 if the registration failed. */ |
87 | int __must_check video_register_device(struct video_device *vdev, int type, int nr); | ||
88 | int __must_check video_register_device_index(struct video_device *vdev, | ||
76 | int type, int nr, int index); | 89 | int type, int nr, int index); |
77 | void video_unregister_device(struct video_device *vfd); | 90 | |
91 | /* Unregister video devices. Will do nothing if vdev == NULL or | ||
92 | vdev->minor < 0. */ | ||
93 | void video_unregister_device(struct video_device *vdev); | ||
78 | 94 | ||
79 | /* helper functions to alloc/release struct video_device, the | 95 | /* helper functions to alloc/release struct video_device, the |
80 | latter can also be used for video_device->release(). */ | 96 | latter can also be used for video_device->release(). */ |
81 | struct video_device * __must_check video_device_alloc(void); | 97 | struct video_device * __must_check video_device_alloc(void); |
82 | 98 | ||
83 | /* this release function frees the vfd pointer */ | 99 | /* this release function frees the vdev pointer */ |
84 | void video_device_release(struct video_device *vfd); | 100 | void video_device_release(struct video_device *vdev); |
85 | 101 | ||
86 | /* this release function does nothing, use when the video_device is a | 102 | /* this release function does nothing, use when the video_device is a |
87 | static global struct. Note that having a static video_device is | 103 | static global struct. Note that having a static video_device is |
88 | a dubious construction at best. */ | 104 | a dubious construction at best. */ |
89 | void video_device_release_empty(struct video_device *vfd); | 105 | void video_device_release_empty(struct video_device *vdev); |
90 | 106 | ||
91 | /* helper functions to access driver private data. */ | 107 | /* helper functions to access driver private data. */ |
92 | static inline void *video_get_drvdata(struct video_device *dev) | 108 | static inline void *video_get_drvdata(struct video_device *vdev) |
93 | { | 109 | { |
94 | return dev_get_drvdata(&dev->dev); | 110 | return dev_get_drvdata(&vdev->dev); |
95 | } | 111 | } |
96 | 112 | ||
97 | static inline void video_set_drvdata(struct video_device *dev, void *data) | 113 | static inline void video_set_drvdata(struct video_device *vdev, void *data) |
98 | { | 114 | { |
99 | dev_set_drvdata(&dev->dev, data); | 115 | dev_set_drvdata(&vdev->dev, data); |
100 | } | 116 | } |
101 | 117 | ||
102 | struct video_device *video_devdata(struct file *file); | 118 | struct video_device *video_devdata(struct file *file); |
@@ -108,4 +124,9 @@ static inline void *video_drvdata(struct file *file) | |||
108 | return video_get_drvdata(video_devdata(file)); | 124 | return video_get_drvdata(video_devdata(file)); |
109 | } | 125 | } |
110 | 126 | ||
127 | static inline int video_is_unregistered(struct video_device *vdev) | ||
128 | { | ||
129 | return test_bit(V4L2_FL_UNREGISTERED, &vdev->flags); | ||
130 | } | ||
131 | |||
111 | #endif /* _V4L2_DEV_H */ | 132 | #endif /* _V4L2_DEV_H */ |