mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-23 20:59:02 +00:00
933a3a3c4a
* Update release number to 78.
Public Issues:
* Change markup so parameter descriptions include links to structures,
instead of just their names (public issue 697).
* Resume publishing updated Vulkan 1.0 + KHR extensions and Vulkan 1.0 +
all extensions versions of the specification (public issue 722).
* Reapply fixes from public pull request 698 for
`VK_ANDROID_external_memory_android_hardware_buffer`, which accidentally
were reverted at some point (public pull request 724).
* Fix undefined format valid usage statements for slink:VkImageCreateInfo
in the presence of the
`VK_ANDROID_external_memory_android_hardware_buffer` extension (public
pull request 725).
* Miscellaneous markup consistency fixes (public pull request 728).
Internal Issues:
* When building specifications containing vendor extensions, add terms to
the Khronos spec copyright specifying that the result is not a ratified
specification (internal issue 739).
* Change the value of the
pname:maxDescriptorSetUpdateAfterBindUniformBuffers minimum limit to 72
(6 times pname:maxPerStageDescriptorUpdateAfterBindUniformBuffers) in
the <<features-limits-required, Required Limits>> table (internal issue
1300).
Other Issues:
* Fix link to resource image view compatibility table in the valid usage
statements for slink:VkImageFormatListCreateInfoKHR (internal pull
request 2711).
60 lines
2.3 KiB
Plaintext
60 lines
2.3 KiB
Plaintext
[[platformCreateSurface_vi,platformCreateSurface_vi]]
|
|
|
|
=== VI Platform
|
|
|
|
[open,refpage='vkCreateViSurfaceNN',desc='Create a slink:VkSurfaceKHR object for a VI layer',type='protos']
|
|
--
|
|
|
|
To create a sname:VkSurfaceKHR object for an code:nn::code:vi::code:Layer,
|
|
query the layer's native handle using
|
|
code:nn::code:vi::code:GetNativeWindow, and then call:
|
|
|
|
include::../../api/protos/vkCreateViSurfaceNN.txt[]
|
|
|
|
* pname:instance is the instance with which to associate the surface.
|
|
* pname:pCreateInfo is a pointer to an instance of the
|
|
sname:VkViSurfaceCreateInfoNN structure containing parameters affecting
|
|
the creation of the surface object.
|
|
* pname:pAllocator is the allocator used for host memory allocated for the
|
|
surface object when there is no more specific allocator available (see
|
|
<<memory-allocation,Memory Allocation>>).
|
|
* pname:pSurface points to a slink:VkSurfaceKHR handle in which the
|
|
created surface object is returned.
|
|
|
|
During the lifetime of a surface created using a particular
|
|
code:nn::code:vi::code:NativeWindowHandle any attempts to create another
|
|
surface for the same code:nn::code:vi::code:Layer and any attempts to
|
|
connect to the same code:nn::code:vi::code:Layer through other platform
|
|
mechanisms will have undefined results.
|
|
|
|
The pname:currentExtent of a VI surface is always undefined.
|
|
Applications are expected to choose an appropriate size for the swapchain's
|
|
pname:imageExtent (e.g., by matching the the result of a call to
|
|
code:nn::code:vi::code:GetDisplayResolution).
|
|
|
|
include::../../validity/protos/vkCreateViSurfaceNN.txt[]
|
|
--
|
|
|
|
[open,refpage='VkViSurfaceCreateInfoNN',desc='Structure specifying parameters of a newly created VI surface object',type='structs']
|
|
--
|
|
|
|
The sname:VkViSurfaceCreateInfoNN structure is defined as:
|
|
|
|
include::../../api/structs/VkViSurfaceCreateInfoNN.txt[]
|
|
|
|
* pname:sType is the type of this structure.
|
|
* pname:pNext is `NULL` or a pointer to an extension-specific structure.
|
|
* pname:flags is reserved for future use.
|
|
* pname:window is the code:nn::code:vi::code:NativeWindowHandle for the
|
|
code:nn::code:vi::code:Layer with which to associate the surface.
|
|
|
|
.Valid Usage
|
|
****
|
|
* [[VUID-VkViSurfaceCreateInfoNN-window-01318]]
|
|
pname:window must: be a valid code:nn::code:vi::code:NativeWindowHandle
|
|
****
|
|
|
|
include::../../validity/structs/VkViSurfaceCreateInfoNN.txt[]
|
|
--
|
|
|