## D.8. VK_KHR_wayland_surface

Name String
  VK_KHR_wayland_surface
Extension Type
  Instance extension
Registered Extension Number
  7
Last Modified Date
  11/28/2015
Revision
  5
IP Status
  No known IP claims.
Dependencies
  - This extension is written against revision 1.0 of the Vulkan API.
  - This extension requires VK_KHR_surface.
Contributors
  - Patrick Doane, Blizzard
  - Jason Ekstrand, Intel
  - Ian Elliott, LunarG
  - Courtney Goeltzenleuchter, LunarG
  - Jesse Hall, Google
  - James Jones, NVIDIA
  - Antoine Labour, Google
  - Jon Leech, Khronos
  - David Mao, AMD
  - Norbert Nopper, Freescale
  - Alon Or-bach, Samsung
  - Daniel Rakos, AMD
  - Graham Sellers, AMD
  - Ray Smith, ARM
  - Jeff Vigil, Qualcomm
  - Chia-I Wu, LunarG
Contacts
  - Jesse Hall, Google
  - Ian Elliott, LunarG

The VK_KHR_wayland_surface extension is an instance extension. It provides a mechanism to create a `VkSurfaceKHR` object (defined by the VK_KHR_surface extension) that refers to a Wayland wl_surface, as well as a query to determine support for rendering to the windows desktop.

### D.8.1. New Object Types

None

### D.8.2. New Enum Constants

- Extending `VkStructureType`:

  - `VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR`

### D.8.3. New Enums

None

### D.8.4. New Structures

- `VkWaylandSurfaceCreateInfoKHR`

### D.8.5. New Functions

- `vkCreateWaylandSurfaceKHR`
- `vkGetPhysicalDeviceWaylandPresentationSupportKHR`

### D.8.6. Issues

1) Does Wayland need a way to query for compatibility between a particular physical device and a specific Wayland display? This would be a more general query than vkGetPhysicalDeviceSurfaceSupportKHR: if the Wayland- specific query returned true for a (VkPhysicalDevice, struct wl_display*) pair, then the physical device could be assumed to support presentation to any VkSurface for surfaces on the display.

    RESOLVED: Yes.  vkGetPhysicalDeviceWaylandPresentationSupportKHR() was added
    to address this issue.

### D.8.7. Version History

- Revision 1, 2015-09-23 (Jesse Hall)

  - Initial draft, based on the previous contents of VK_EXT_KHR_swapchain (later renamed VK_EXT_KHR_surface).

- Revision 2, 2015-10-02 (James Jones)

  - Added vkGetPhysicalDeviceWaylandPresentationSupportKHR() to resolve issue #1.
  - Adjusted wording of issue #1 to match the agreed-upon solution.
  - Renamed "window" parameters to "surface" to match Wayland conventions.

- Revision 3, 2015-10-26 (Ian Elliott)

  - Renamed from VK_EXT_KHR_wayland_surface to VK_KHR_wayland_surface.

- Revision 4, 2015-11-03 (Daniel Rakos)

  - Added allocation callbacks to vkCreateWaylandSurfaceKHR.

- Revision 5, 2015-11-28 (Daniel Rakos)

  - Updated the surface create function to take a pCreateInfo structure.