## D.10. VK_KHR_xcb_surface

Name String
  VK_KHR_xcb_surface
Extension Type
  Instance extension
Registered Extension Number
  6
Last Modified Date
  11/28/2015
Revision
  6
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_xcb_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 an X11 window, using the XCB client-side library, as well as a query to determine support for rendering via XCB.

### D.10.1. New Object Types

None

### D.10.2. New Enum Constants

- Extending `VkStructureType`:

  - `VK_STRUCTURE_TYPE_XCB_SURFACE_CREATE_INFO_KHR`

### D.10.3. New Enums

None

### D.10.4. New Structures

- `VkXcbSurfaceCreateInfoKHR`

### D.10.5. New Functions

- `vkCreateXcbSurfaceKHR`
- `vkGetPhysicalDeviceXcbPresentationSupportKHR`

### D.10.6. Issues

1) Does XCB need a way to query for compatibility between a particular physical device and a specific screen? This would be a more general query than vkGetPhysicalDeviceSurfaceSupportKHR: If it returned true, then the physical device could be assumed to support presentation to any window on that screen.

    RESOLVED: Yes, this is needed for toolkits that want to create a VkDevice
    before creating a window.  To ensure the query is reliable, it must be
    made against a particular X visual rather than the screen in general.

### D.10.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 presention support query for an (xcb_connection_t*, xcb_visualid_t) pair.
  - Removed "root" parameter from CreateXcbSurfaceKHR(), as it is redundant when a window on the same screen is specified as well.
  - Adjusted wording of issue #1 and added agreed upon resolution.

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

  - Removed "root" parameter from CreateXcbSurfaceKHR() in one more place.

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

  - Renamed from VK_EXT_KHR_xcb_surface to VK_KHR_xcb_surface.

- Revision 5, 2015-10-23 (Daniel Rakos)

  - Added allocation callbacks to vkCreateXcbSurfaceKHR.

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

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