SYNOPSIS
- int drm_atomic_helper_commit(struct drm_device * dev, struct drm_atomic_state * state, bool nonblock);
ARGUMENTS
dev
-
- DRM device
state
- the driver state object
nonblock
- -- undescribed --
DESCRIPTION
This function commits a with drm_atomic_helper_check pre-validated state object. This can still fail when e.g. the framebuffer reservation fails. For now this doesn't implement nonblocking commits.
Note that right now this function does not support nonblocking commits, hence driver writers must implement their own version for now. Also note that the default ordering of how the various stages are called is to match the legacy modeset helper library closest. One peculiarity of that is that it doesn't mesh well with runtime PM at all.
For drivers supporting runtime PM the recommended sequence is
drm_atomic_helper_commit_modeset_disables(dev, state);
drm_atomic_helper_commit_modeset_enables(dev, state);
drm_atomic_helper_commit_planes(dev, state, true);
See the kerneldoc entries for these three functions for more details.
RETURNS Zero for success or -errno.
AUTHORS
Jesse Barnes <[email protected]>
Intel Corporation,
- Initial version
Laurent Pinchart <[email protected]>
Ideas on board SPRL,
- Driver internals
Daniel Vetter <[email protected]>
Intel Corporation,
- Contributions all over the place
Lukas Wunner <[email protected]>
- vga_switcheroo documentation
COPYRIGHT