[PATCH vkd3d 6/8] include: Document API versions.

[Józef Kucia]

From: Józef Kucia <jkucia at codeweavers.com>

Signed-off-by: Józef Kucia <jkucia at codeweavers.com>
---
 include/vkd3d.h        | 39 ++++++++++++++++++++++-----------------
 include/vkd3d_shader.h |  1 +
 include/vkd3d_utils.h  |  1 +
 3 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/include/vkd3d.h b/include/vkd3d.h
index b78076e43927..e2d9ec81f2c4 100644
--- a/include/vkd3d.h
+++ b/include/vkd3d.h
@@ -36,12 +36,15 @@ extern "C" {
 
 enum vkd3d_structure_type
 {
+    /* 1.0 */
     VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO,
     VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO,
     VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO,
 
+    /* 1.1 */
     VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO,
 
+    /* 1.2 */
     VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO,
     VKD3D_STRUCTURE_TYPE_APPLICATION_INFO,
 
@@ -74,7 +77,7 @@ struct vkd3d_instance_create_info
     uint32_t instance_extension_count;
 };
 
-/* Extends vkd3d_instance_create_info. */
+/* Extends vkd3d_instance_create_info. Available since 1.1. */
 struct vkd3d_optional_instance_extensions_info
 {
     enum vkd3d_structure_type type;
@@ -84,7 +87,7 @@ struct vkd3d_optional_instance_extensions_info
     uint32_t extension_count;
 };
 
-/* Extends vkd3d_instance_create_info. */
+/* Extends vkd3d_instance_create_info. Available since 1.2. */
 struct vkd3d_application_info
 {
     enum vkd3d_structure_type type;
@@ -116,7 +119,7 @@ struct vkd3d_device_create_info
     LUID adapter_luid;
 };
 
-/* Extends vkd3d_device_create_info. */
+/* Extends vkd3d_device_create_info. Available since 1.2. */
 struct vkd3d_optional_device_extensions_info
 {
     enum vkd3d_structure_type type;
@@ -167,18 +170,19 @@ ULONG vkd3d_resource_incref(ID3D12Resource *resource);
 
 HRESULT vkd3d_serialize_root_signature(const D3D12_ROOT_SIGNATURE_DESC *desc,
         D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob);
-
-HRESULT vkd3d_serialize_versioned_root_signature(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
-        ID3DBlob **blob, ID3DBlob **error_blob);
-
 HRESULT vkd3d_create_root_signature_deserializer(const void *data, SIZE_T data_size,
         REFIID iid, void **deserializer);
 
-HRESULT vkd3d_create_versioned_root_signature_deserializer(const void *data, SIZE_T data_size,
-        REFIID iid, void **deserializer);
+VkFormat vkd3d_get_vk_format(DXGI_FORMAT format);
 
+/* 1.1 */
 DXGI_FORMAT vkd3d_get_dxgi_format(VkFormat format);
-VkFormat vkd3d_get_vk_format(DXGI_FORMAT format);
+
+/* 1.2 */
+HRESULT vkd3d_serialize_versioned_root_signature(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
+        ID3DBlob **blob, ID3DBlob **error_blob);
+HRESULT vkd3d_create_versioned_root_signature_deserializer(const void *data, SIZE_T data_size,
+        REFIID iid, void **deserializer);
 
 #endif  /* VKD3D_NO_PROTOTYPES */
 
@@ -209,18 +213,19 @@ typedef ULONG (*PFN_vkd3d_resource_incref)(ID3D12Resource *resource);
 
 typedef HRESULT (*PFN_vkd3d_serialize_root_signature)(const D3D12_ROOT_SIGNATURE_DESC *desc,
         D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob);
-
-typedef HRESULT (*PFN_vkd3d_serialize_versioned_root_signature)(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
-        ID3DBlob **blob, ID3DBlob **error_blob);
-
 typedef HRESULT (*PFN_vkd3d_create_root_signature_deserializer)(const void *data, SIZE_T data_size,
         REFIID iid, void **deserializer);
 
-typedef HRESULT (*PFN_vkd3d_create_versioned_root_signature_deserializer)(const void *data, SIZE_T data_size,
-        REFIID iid, void **deserializer);
+typedef VkFormat (*PFN_vkd3d_get_vk_format)(DXGI_FORMAT format);
 
+/* 1.1 */
 typedef DXGI_FORMAT (*PFN_vkd3d_get_dxgi_format)(VkFormat format);
-typedef VkFormat (*PFN_vkd3d_get_vk_format)(DXGI_FORMAT format);
+
+/* 1.2 */
+typedef HRESULT (*PFN_vkd3d_serialize_versioned_root_signature)(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
+        ID3DBlob **blob, ID3DBlob **error_blob);
+typedef HRESULT (*PFN_vkd3d_create_versioned_root_signature_deserializer)(const void *data, SIZE_T data_size,
+        REFIID iid, void **deserializer);
 
 #ifdef __cplusplus
 }
diff --git a/include/vkd3d_shader.h b/include/vkd3d_shader.h
index e6cccd84cc67..fcf5db8efc03 100644
--- a/include/vkd3d_shader.h
+++ b/include/vkd3d_shader.h
@@ -29,6 +29,7 @@ extern "C" {
 
 enum vkd3d_shader_structure_type
 {
+    /* 1.2 */
     VKD3D_SHADER_STRUCTURE_TYPE_SHADER_INTERFACE_INFO,
     VKD3D_SHADER_STRUCTURE_TYPE_COMPILE_ARGUMENTS,
     VKD3D_SHADER_STRUCTURE_TYPE_SCAN_INFO,
diff --git a/include/vkd3d_utils.h b/include/vkd3d_utils.h
index 6c926e4e1643..8a5689a80c3d 100644
--- a/include/vkd3d_utils.h
+++ b/include/vkd3d_utils.h
@@ -28,6 +28,7 @@ extern "C" {
 #define VKD3D_WAIT_FAILED (~0u)
 #define VKD3D_INFINITE (~0u)
 
+/* 1.0 */
 HANDLE vkd3d_create_event(void);
 HRESULT vkd3d_signal_event(HANDLE event);
 unsigned int vkd3d_wait_event(HANDLE event, unsigned int milliseconds);
-- 
2.21.0