VK_GOOGLE_surfaceless_query(3)

# VK_GOOGLE_surfaceless_query(3) Manual Page

## Name

VK_GOOGLE_surfaceless_query - instance extension

Loading… please wait.

## Registered Extension Number

434

## Revision

1

## Extension and Version Dependencies

- Requires support for Vulkan 1.0

- Requires `VK_KHR_surface` to be enabled

## Special Use

- OpenGL / ES support

## Contact

- Shahbaz Youssefi syoussefi

## Extension Proposal

VK_GOOGLE_surfaceless_query

## Other Extension Metadata

Last Modified Date

  2021-12-14

IP Status

  No known IP claims.

Contributors

  - Ian Elliott, Google

  - Shahbaz Youssefi, Google

  - James Jones, NVIDIA

## Description

This extension allows the vkGetPhysicalDeviceSurfaceFormatsKHR and vkGetPhysicalDeviceSurfacePresentModesKHR functions to accept VK_NULL_HANDLE as their `surface` parameter, allowing potential surface formats, colorspaces and present modes to be queried without providing a surface. Identically, vkGetPhysicalDeviceSurfaceFormats2KHR and vkGetPhysicalDeviceSurfacePresentModes2EXT would accept VK_NULL_HANDLE in VkPhysicalDeviceSurfaceInfo2KHR::`surface`. This can only be supported on platforms where the results of these queries are surface-agnostic and a single presentation engine is the implicit target of all present operations.

## New Enum Constants

- `VK_GOOGLE_SURFACELESS_QUERY_EXTENSION_NAME`

- `VK_GOOGLE_SURFACELESS_QUERY_SPEC_VERSION`

## Version History

- Revision 1, 2021-12-14 (Shahbaz Youssefi)

  - Internal revisions

## See Also

No cross-references are available

## Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

## Copyright

Copyright 2014-2022 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0