Debian Codegraph @

include/drm/drm_vblank_work.h

raw
1 /* SPDX-License-Identifier: MIT */
2
3 #ifndef _DRM_VBLANK_WORK_H_
4 #define _DRM_VBLANK_WORK_H_
5
6 #include <linux/kthread.h>
7
8 struct drm_crtc;
9
10 /**
11 * struct drm_vblank_work - A delayed work item which delays until a target
12 * vblank passes, and then executes at realtime priority outside of IRQ
13 * context.
14 *
15 * See also:
16 * drm_vblank_work_schedule()
17 * drm_vblank_work_init()
18 * drm_vblank_work_cancel_sync()
19 * drm_vblank_work_flush()
20 * drm_vblank_work_flush_all()
21 */
22 struct drm_vblank_work {
23 /**
24 * @base: The base &kthread_work item which will be executed by
25 * &drm_vblank_crtc.worker. Drivers should not interact with this
26 * directly, and instead rely on drm_vblank_work_init() to initialize
27 * this.
28 */
29 struct kthread_work base;
30
31 /**
32 * @vblank: A pointer to &drm_vblank_crtc this work item belongs to.
33 */
34 struct drm_vblank_crtc *vblank;
35
36 /**
37 * @count: The target vblank this work will execute on. Drivers should
38 * not modify this value directly, and instead use
39 * drm_vblank_work_schedule()
40 */
41 u64 count;
42
43 /**
44 * @cancelling: The number of drm_vblank_work_cancel_sync() calls that
45 * are currently running. A work item cannot be rescheduled until all
46 * calls have finished.
47 */
48 int cancelling;
49
50 /**
51 * @node: The position of this work item in
52 * &drm_vblank_crtc.pending_work.
53 */
54 struct list_head node;
55 };
56
57 /**
58 * to_drm_vblank_work - Retrieve the respective &drm_vblank_work item from a
59 * &kthread_work
60 * @_work: The &kthread_work embedded inside a &drm_vblank_work
61 */
62 #define to_drm_vblank_work(_work) \
63 container_of((_work), struct drm_vblank_work, base)
64
65 int drm_vblank_work_schedule(struct drm_vblank_work *work,
66 u64 count, bool nextonmiss);
67 void drm_vblank_work_init(struct drm_vblank_work *work, struct drm_crtc *crtc,
68 void (*func)(struct kthread_work *work));
69 bool drm_vblank_work_cancel_sync(struct drm_vblank_work *work);
70 void drm_vblank_work_flush(struct drm_vblank_work *work);
71 void drm_vblank_work_flush_all(struct drm_crtc *crtc);
72
73 #endif /* !_DRM_VBLANK_WORK_H_ */