D语言+Vulkan开发OpenXR应用：xrCreateInstance调用失败求助

我正在用D语言结合Vulkan开发OpenXR应用，大部分集成和库管理工作都是自行完成的。目前已能创建Vulkan窗口并显示简单立方体，OpenXR库已链接成功且可查询扩展，判断库绑定无误，但调用xrCreateInstance()时返回XR_ERROR_API_VERSION_UNSUPPORTED错误，无法确定正确API版本。

我编写了循环遍历多版本号进行测试：

uint[] majorVersions = [0, 1];
int[] minorVersions = iota(0, 100).array; // 按需添加更多小版本
int[] patchVersions = iota(0, 51).array; // 按需添加更多补丁版本

foreach (major; majorVersions) {
    foreach (minor; minorVersions) {
        foreach (patch; patchVersions) {
            appInfo.apiVersion = XR_MAKE_VERSION(major, minor, patch);
            createInfo.applicationInfo = appInfo;

            XrResult result = xrCreateInstance(&createInfo, &instance);

但仍输出大量错误：

Error [GENERAL | xrCreateInstance | OpenXR-Loader] : xrCreateInstance failed
Error [GENERAL | xrCreateInstance | OpenXR-Loader] : LoaderInstance::CreateInstance chained CreateInstance call failed

我认为问题并非OpenXR版本本身，但不知如何排查，恳请提供思路！

相关代码片段 #

实例创建信息

XrApplicationInfo appInfo = {
    applicationName: "D OpenXR Application".toStringz,
    applicationVersion: 0,
    engineName: "Test".toStringz,
    engineVersion: 0,
    apiVersion: XR_API_VERSION_1_0,    
};

const(char)*[] enabledApiLayers = [
    "XR_APILAYER_LUNARG_core_validation"
    "XR_APILAYER_LUNARG_standard_validation"
];

const(char)*[] enabledExtensions = [
    "XR_KHR_vulkan_enable2",
];

XrInstanceCreateInfo createInfo = {
    type: XrStructureType.XR_TYPE_INSTANCE_CREATE_INFO,
    next: null,
    createFlags: 0,
    applicationInfo: appInfo,
    enabledApiLayerCount: cast(uint)enabledApiLayers.length,
    enabledApiLayerNames: enabledApiLayers.ptr,
    enabledExtensionCount: cast(uint)enabledExtensions.length,
    enabledExtensionNames: enabledExtensions.ptr,
};

API版本定义

enum XR_CURRENT_API_VERSION = XR_MAKE_VERSION(1, 0, 26);
/***
Combines major, minor, and patch version numbers into a single 64-bit integer.
Equivalent to the OpenXR XR_MAKE_VERSION macro in C/C++.

Params:
    The major version number is a 16-bit integer packed into bits 63-48.
    The minor version number is a 16-bit integer packed into bits 47-32.
    The patch version number is a 32-bit integer packed into bits 31-0.

Returns:
   A 64-bit integer encoding the version.
*/

long XR_MAKE_VERSION(uint major, uint minor, uint patch) 
{

    return ((cast(long)(major & 0xffff) << 48) |
        (cast(long)(minor & 0xffff) << 32) |
        (cast(long)(patch & 0xffffffff)));
}

uint XR_VERSION_PATCH(ulong _version) 
{
    return cast(uint)(_version & 0xffffffff);
}

enum XR_API_VERSION_1_0 = XR_MAKE_VERSION(1, 0, XR_VERSION_PATCH(XR_CURRENT_API_VERSION));

结构体定义

struct XrApplicationInfo {
    const(char)* applicationName;
    uint32_t applicationVersion;
    const(char)* engineName;
    uint32_t engineVersion;
    uint64_t apiVersion;
}

struct XrInstanceCreateInfo {
    XrStructureType type;
    const(void)* next;
    XrInstanceCreateFlags createFlags;
    XrApplicationInfo applicationInfo;
    uint32_t enabledApiLayerCount;
    const(char)** enabledApiLayerNames;
    uint32_t enabledExtensionCount;
    const(char)** enabledExtensionNames;
}

1. 修正XR_MAKE_VERSION的类型与位序实现 #

OpenXR的apiVersion是uint64_t（对应D语言的ulong），你当前的XR_MAKE_VERSION返回long（有符号64位），可能导致符号位干扰。同时要确保位运算完全符合OpenXR规范：

• 修改返回类型为ulong，避免符号问题：

ulong XR_MAKE_VERSION(uint major, uint minor, uint patch) 
{
    return ((cast(ulong)(major & 0xffff) << 48) |
            (cast(ulong)(minor & 0xffff) << 32) |
            (cast(ulong)(patch & 0xffffffff)));
}

• 将XR_CURRENT_API_VERSION、XR_API_VERSION_1_0的类型统一为ulong，和XrApplicationInfo的apiVersion类型匹配。

2. 排查验证层冲突或兼容性问题 #

你同时启用了XR_APILAYER_LUNARG_core_validation和XR_APILAYER_LUNARG_standard_validation，但后者已经包含前者，重复启用可能引发冲突；另外验证层版本可能和OpenXR运行时不兼容：

• 先禁用所有验证层，将enabledApiLayers设为空数组，重新测试实例创建。如果成功，说明是验证层问题：
  • 只保留standard_validation即可；
  • 确认验证层已正确安装，版本与OpenXR Loader匹配。

3. 获取运行时支持的准确版本 #

不要盲目遍历版本，调用xrEnumerateInstanceVersion直接获取运行时支持的最高API版本：

ulong runtimeVersion;
XrResult result = xrEnumerateInstanceVersion(&runtimeVersion);
if (result == XR_SUCCESS) {
    // 直接使用运行时支持的版本
    appInfo.apiVersion = runtimeVersion;
}

用这个版本测试，能直接排除版本不匹配的问题。

4. 检查扩展兼容性 #

你启用了XR_KHR_vulkan_enable2，需确认：

• OpenXR运行时支持该扩展；
• Vulkan版本符合扩展要求；
• 先禁用该扩展，测试实例创建是否成功，排除扩展导致的版本兼容问题。

5. 确保结构体与C ABI兼容 #

OpenXR是C API，D语言默认结构体布局与C不同，必须保证内存布局完全一致：

• 在结构体定义前添加extern(C)标记，强制使用C的ABI规则：

extern(C) struct XrApplicationInfo {
    const(char)* applicationName;
    uint32_t applicationVersion;
    const(char)* engineName;
    uint32_t engineVersion;
    uint64_t apiVersion;
}

extern(C) struct XrInstanceCreateInfo {
    XrStructureType type;
    const(void)* next;
    XrInstanceCreateFlags createFlags;
    XrApplicationInfo applicationInfo;
    uint32_t enabledApiLayerCount;
    const(char)** enabledApiLayerNames;
    uint32_t enabledExtensionCount;
    const(char)** enabledExtensionNames;
}

这是D语言调用C API的常见坑，结构体布局不匹配会导致参数传递错误，进而触发版本错误。

6. 开启详细日志定位问题 #

设置环境变量开启OpenXR Loader的详细日志，获取更精准的错误原因：

• 设置XR_LOADER_DEBUG=all，运行程序后查看完整日志，日志会明确指出是版本不兼容的具体原因，或是验证层、扩展的问题。

内容的提问来源于stack exchange，提问作者infinityplusb