Giovanni Mascellani : include: Document struct vkd3d_optional_instance_extensions_info.

[Alexandre Julliard]

Module: vkd3d
Branch: master
Commit: d27bbce0e11d2a2d71cbbd4a7166ea76d31cb947
URL:    https://gitlab.winehq.org/wine/vkd3d/-/commit/d27bbce0e11d2a2d71cbbd4a7166ea...

Author: Giovanni Mascellani <gmascellani(a)codeweavers.com>
Date:   Sat Apr 20 23:40:44 2024 +0200

include: Document struct vkd3d_optional_instance_extensions_info.

---

 include/vkd3d.h | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/include/vkd3d.h b/include/vkd3d.h
index d72a7b38..6e0c82f8 100644
--- a/include/vkd3d.h
+++ b/include/vkd3d.h
@@ -151,13 +151,26 @@ struct vkd3d_instance_create_info
     uint32_t instance_extension_count;
 };
 
-/* Extends vkd3d_instance_create_info. Available since 1.1. */
+/**
+ * A chained structure to specify optional instance extensions.
+ *
+ * This structure extends vkd3d_instance_create_info.
+ *
+ * \since 1.1
+ */
 struct vkd3d_optional_instance_extensions_info
 {
+    /** Must be set to VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO. */
     enum vkd3d_structure_type type;
+    /** Optional pointer to a structure containing further parameters. */
     const void *next;
 
+    /**
+     * A list of optional Vulkan instance extensions to request. Instance creation does not fail if
+     * they are not available.
+     */
     const char * const *extensions;
+    /** The number of elements in the extensions array. */
     uint32_t extension_count;
 };