接口名	描述
VKAPI_ATTR VkResult VKAPI_CALL HMS_XEG_CreateHPS (VkDevice device, const XEG_HPSCreateInfo pCreateInfo, XEG_HPS pHps)	创建XEG_HPS对象。
VKAPI_ATTR void VKAPI_CALL HMS_XEG_DestroyHPS (XEG_HPS hps)	销毁XEG_HPS对象。
VKAPI_ATTR VkResult VKAPI_CALL HMS_XEG_CmdRadixSortHPS (VkCommandBuffer commandBuffer, XEG_HPS hps, const XEG_HPSRadixSortDescription *pDescription)	录制HPS排序命令，使用此接口前需要通过HMS_XEG_EnumerateDeviceExtensionProperties接口查询是否支持XEG_HPS_RADIX_SORT_EXTENSION_NAME扩展。

业务流程

下面是以Vulkan应用程序渲染为例，说明使用高性能GPU排序的主要业务流程

应用调用HMS_XEG_EnumerateDeviceExtensionProperties接口获取XEngine Kit支持的扩展属性列表。检查返回列表中是否包含XEG_HPS_RADIX_SORT_EXTENSION_NAME。若不包含，则当前设备不支持此特性，流程终止。
应用准备HPS相关资源（keyBuffer、indexBuffer等）。
应用调用HMS_XEG_CreateHPS接口创建HPS实例。
应用调用HMS_XEG_CmdRadixSortHPS录制排序命令，并提交到GPU队列执行。
当不再需要排序时，应用调用HMS_XEG_DestroyHPS接口销毁HPS实例，释放全部GPU资源。销毁后HPS句柄失效，不可再使用。

开发步骤

本章以在Vulkan应用程序渲染为例，说明使用高性能GPU排序的开发步骤。

[h2]配置项目

编译HAP包时，Native层so需要依赖NDK中的XEngine相关库和头文件。

头文件引用

#include <algorithm>
#include <vector>
#include <string>
#include <xengine/xeg_vulkan_hps.h>
#include <xengine/xeg_vulkan_extension.h>
#include <xengine/xeg_extension_defs.h>

CMakeLists.txt添加库依赖

CMakeLists.txt中添加对XEngine动态链接库依赖的代码如下。

find_library(
    # 设置路径变量的名称。
    xengine-lib
    # 指定希望CMake定位的NDK库的名称。
    xengine
)
target_link_libraries(nativerender PUBLIC
    # 其他库文件
    # ...
    ${xengine-lib})

[h2]集成高性能GPU排序（Vulkan）

XEngine 高性能GPU排序可以独立使用。相关代码在Native层实现。

在调用XEngine Kit特性接口前，需要先通过Syscap查询确认您的目标设备支持SystemCapability.Graphic.XEngine系统能力。

调用HMS_XEG_EnumerateDeviceExtensionProperties接口，获取XEngine支持的扩展信息，只有在支持XEG_HPS_RADIX_SORT_EXTENSION_NAME扩展时才可以使用高性能GPU排序接口。

VkPhysicalDevice physicalDevice;
std::vector<std::string> supportedExtensions;
uint32_t propertyCount;
HMS_XEG_EnumerateDeviceExtensionProperties(physicalDevice, &propertyCount, nullptr);
if (propertyCount > 0) {
    std::vector<XEG_ExtensionProperties> properties(propertyCount);
    if (HMS_XEG_EnumerateDeviceExtensionProperties(physicalDevice, &propertyCount, &properties.front()) ==
        VK_SUCCESS) {
        for (auto ext : properties) {
            supportedExtensions.push_back(ext.extensionName);
        }
    }
}
if (std::find(supportedExtensions.begin(), supportedExtensions.end(), XEG_HPS_RADIX_SORT_EXTENSION_NAME) ==
    supportedExtensions.end()) {
    exit(1);
}

准备HPS相关资源。

VkDevice device;
VkCommandBuffer cmdBuffer;
VkQueue queue;
// 要被排序的key
VkBuffer keyBuffer;
// 与key对应的value
VkBuffer indexBuffer;
// 排序量
VkBuffer sortCount;

声明实例句柄。
```
XEG_HPS xegHPS { VK_NULL_HANDLE };
```

调用HMS_XEG_CreateHPS接口，实例化句柄。

// 构造输入描述符
XEG_HPSRadixSort sortInfo{
    XEG_STRUCTURE_TYPE_HPS_RADIX_SORT,
    nullptr
};

XEG_HPSCreateInfo info {
    XEG_STRUCTURE_TYPE_HPS_CREATE_INFO,
    &sortInfo
};
// 实例化句柄
VkResult res = HMS_XEG_CreateHPS(device, &info, &xegHPS);
if (res != VK_SUCCESS) {
    // 错误处理
    // ...
}

构造排序描述符，调用HMS_XEG_CmdRadixSortHPS接口录制排序命令。

VkCommandBufferBeginInfo cmdBufferBeginInfo {};
cmdBufferBeginInfo.sType = VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO;

// 录制排序命令
vkBeginCommandBuffer(cmdBuffer, &cmdBufferBeginInfo);
XEG_HPSRadixSortDescription sortDescription{
    XEG_STRUCTURE_TYPE_HPS_RADIX_SORT_DESCRIPTION,
    nullptr,
    sortCount,
    keyBuffer,
    indexBuffer
};
VkResult res = HMS_XEG_CmdRadixSortHPS(cmdBuffer, xegHPS, &sortDescription);
if (res != VK_SUCCESS) {
    // 错误处理
    // ...
}
vkEndCommandBuffer(cmdBuffer);

提交排序命令。

// 提交command buffer
VkResult res;
{
    VkSubmitInfo submitInfo{};
    submitInfo.sType = VK_STRUCTURE_TYPE_SUBMIT_INFO;
    submitInfo.waitSemaphoreCount = 0;
    submitInfo.signalSemaphoreCount = 0;
    submitInfo.pSignalSemaphores = nullptr;
    submitInfo.commandBufferCount = 1;
    submitInfo.pCommandBuffers = &cmdBuffer;
    submitInfo.pWaitSemaphores = nullptr;
    res = vkQueueSubmit(queue, 1, &submitInfo, nullptr);
}
// 等待结束
vkDeviceWaitIdle(device);

销毁HPS对象。

if(xegHPS){
    HMS_XEG_DestroyHPS(xegHPS);
}

目录

高性能GPU排序

约束与限制

接口说明

业务流程

开发步骤

[h2]配置项目

[h2]集成高性能GPU排序（Vulkan）