Vulkan-Docs/doc/specs/vulkan/man/vkEnumerateInstanceExtensionProperties.txt
Jon Leech 8c3c9b4c85 Change log for March 25, 2016 Vulkan 1.0.7 spec update:
* Bump API patch number and header version number to 7 for this
    update.

Github Issues:

  * Fix slink:VkSpecializationMapEntry example to avoid C/C++ strict
    aliasing issues (public issue 14).

  * Clarify the meaning of "matching" in flink:vkCmdBindDescriptorSets
    validity language (public issue 33).

  * Add stub reference pages so xrefs to not-yet-written pages don't
    generate 404 errors. However, the actual content of these pages
    still needs to be filled in as time allows (public issue 44, but
    does not close that issue out).

  * Remove incorrect validity statement for
    flink:vkGetImageSparseMemoryRequirements (public issue 85).

  * Reword the
    <<features-limits-bufferImageGranularity,bufferImageGranularity>>
    feature in terms of "aliasing", and clarify that it applies to
    bindings in the same memory object (public issue 90).

  * Clarify the relationship of the slink:VkPhysicalDeviceLimits
    pname:maxViewportDimensions and pname:viewportBoundsRange limits
    (public issue 92).

  * Specify sparse unbound texture replacement in the
    <<textures-texel-replacement,Texel Replacement>> section
    independently of robust buffer access language (public issue 100).

  * Add the <<fundamentals-architecture-model,Architecture Model>>
    section to explain architecture constraints Vulkan has chosen to
    accept in order to enable portable and performant code (public issue
    122).

  * State that an object must not be destroyed until *all* (not *any*)
    uses of that object have completed (public issue 123).

  * Minor editorial cleanup (public issues 129, 134, 146, 148).

  * Add validity language for layer and extension names to
    slink:VkDeviceCreateInfo matching that used for
    slink:VkInstanceCreateInfo (public issue 130).

  * Clean up terminology for the case when the bits set in one bitmask
    are a subset of the bits set in another bitmask (public issue 138).

  * Document that input attachments are UniformConstant not Input, in
    the <<interfaces-inputattachment,Fragment Input Attachment
    Interface>> section (public glslang bug 169).

Internal Issues:

  * Add max enum values to "flag bits" enums (internal issue #136).

  * Clarify language around the various uses of the term "block" in the
    <<appendix-compressedtex-bc,Block Compressed Image Formats>> section
    (internal issue #202).

  * Removed "expand" dependency from <enums> groups in vk.xml and added
    auto-generation code in the scripts to infer it instead, to ensure
    consistency. This caused renaming of sname:VkColorSpaceKHR and
    sname:VkPresentModeKHR etext:BEGIN_RANGE (etc.) tokens, but those
    tokens are metadata, not part of the API, and the Vulkan WG is OK
    with this change. This change adds ranges to two additional enums
    that were missing them due to not defining the "expand" attribute
    (internal issue 217).

  * Tweak makefile to generate ref page nroff (.3) files in the right
    output directory, working around an a2x limitation (internal issue
    223).

Other Commits:

  * Add validity requirements for flink:vkCmdCopyQueryPoolResults
    pname:dstBuffer parameter.

  * Fix ref page build to generate .3 targets in the right output
    directory.
2016-03-25 02:25:04 -07:00

58 lines
1.9 KiB
Plaintext

vkEnumerateInstanceExtensionProperties(3)
=========================================
Name
----
vkEnumerateInstanceExtensionProperties - Returns up to requested number of global extension properties.
C Specification
---------------
include::../protos/vkEnumerateInstanceExtensionProperties.txt[]
Parameters
----------
pname:pLayerName::
Pointer to optional layer name. If not null, will only return extension
properties for the requested layer.
pname:pPropertyCount::
Pointer to count indicating space available on input and structures
returned on output.
pname:pProperties::
Pointer to a data structure to receive the results.
Description
-----------
fname:vkEnumerateInstanceExtensionProperties retrieves properties for global
extensions of the loader or the optionally specified layer.
pname:pProperties points to an array of sname:VkExtensionProperties where
the return data will be stored. If NULL,
fname:vkEnumerateInstanceExtensionProperties will update the count with the
number of global extensions found. pname:pPropertyCount must point to a
count indicating the number of sname:VkExtensionProperties structures
available. The definition of slink:VkExtensionProperties is as follows:
include::../structs/VkExtensionProperties.txt[]
include::../validity/protos/vkEnumerateInstanceExtensionProperties.txt[]
Return Value
------------
Upon success, fname:vkEnumerateInstanceExtensionProperties returns ename:VK_SUCCESS or ename:VK_INCOMPLETE.
ename:VK_INCOMPLETE indicates that the number of extension properties found exceeds the given count. An app
will need to call again with a larger array and count to get all available extension properties.
The number of available extensions could change from one call to the next if an application
updates or installs Vulkan components.
See Also
--------
flink:vkEnumerateInstanceLayerProperties, flink:vkCreateInstance
include::footer.txt[]