XR_KHR_extended_struct_name_lengths

이름 문자열

XR_KHR_extended_struct_name_lengths

확장 프로그램 유형

인스턴스 확장 프로그램

등록된 확장 프로그램 번호

149

버전

2

비준 상태

비준됨

확장 프로그램 및 버전 종속성

OpenXR 1.0

최종 수정일

2025-12-04

IP 상태

알려진 IP 클레임이 없습니다.

도움을 주신 분들

Matthew Langille, Meta Platforms
Andreas Selvik, Meta Platforms
Rylie Pavlik, Collabora, Ltd.

개요

이 확장 프로그램은 최대 구조체 이름 크기를 확장하고 이러한 새로운 확장된 이름에 액세스하는 새로운 함수를 제공합니다.

xrStructureTypeToString2KHR은 null 종결자를 포함하여 64바이트인 원래 제한인 63바이트를 초과하는 길이의 구조체 유형 열거형의 문자열 이름을 검색할 수 있도록 제공됩니다. xrStructureTypeToString2KHR은 null 종결자를 포함하여 최대 256바이트인 길이의 구조체 유형 열거형의 이름 문자열을 반환합니다. 애플리케이션은 문자열 이름 길이에 관계없이 모든 구조체 유형 열거형에서 작동하므로 xrStructureTypeToString2KHR을 xrStructureTypeToString 의 드롭인 대체로 사용할 수 있습니다.

구조체 유형 열거형 문자열 검색

원래 xrStructureTypeToString이 63바이트를 초과하는 이름 길이의 구조체 유형 열거형의 문자열 이름을 검색하는 데 사용되는 경우 동작은 다음과 같이 명확히 합니다. xrStructureTypeToString은 사용 가능한 버퍼 내에 맞도록 코드 포인트 경계에서 문자열을 자르는 것을 제외하고 올바른 이름으로 버퍼를 채워야 합니다. 즉, 반환된 문자열은 항상 유효한 UTF-8이어야 합니다.

xrStructureTypeToString2KHR 함수는 다음과 같이 정의됩니다.

XrResult xrStructureTypeToString2KHR(
    XrInstance                                  instance,
    XrStructureType                             value,
    char                                        buffer[XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR]);

매개변수 설명

  • instance는 문자열을 요청할 인스턴스의 핸들입니다.
  • value는 XrStructureType 문자열로 변환할 값입니다.
  • buffer는 문자열을 반환하는 데 사용되는 버퍼입니다.

유효한 null로 끝나는 UTF-8 문자열을 buffer에 복사하여 제공된 XrStructureType 값의 이름을 반환합니다 .

모든 경우에 반환된 문자열은 다음 중 하나여야 합니다.

구조체 유형 문자열 출력 값

  • 핵심 사양 또는 확장 프로그램에서 제공된 숫자 값에 대해 정의된 리터럴 문자열입니다. (예: XR_TYPE_INSTANCE_CREATE_INFO 값은 XR_TYPE_INSTANCE_CREATE_INFO 문자열을 생성합니다.)
  • 구조체 유형 번호가 10진수로 표현된 구조체 유형 번호와 연결된 XR_UNKNOWN_STRUCTURE_TYPE_입니다.

이름이 원래 크기 제한인 63바이트 내에 맞는 구조체 유형 열거형의 경우 xrStructureTypeToString2KHR은 null 종결자까지 xrStructureTypeToString과 동일한 결과 문자열을 반환해야 합니다.

유효한 사용 (암시적)

  • XR_KHR_extended_struct_name_lengths 확장 프로그램을 xrStructureTypeToString2KHR을 호출하기 전에 사용 설정해야 합니다.
  • instance 는 유효한 XrInstance 핸들이어야 합니다
  • value 는 유효한 XrStructureType 값이어야 합니다
  • buffer 는 길이가 XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR인 문자 배열이어야 합니다.

반환 코드

성공

  • XR_SUCCESS

실패

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_VALIDATION_FAILURE

XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR 열거형은 xrStructureTypeToString2KHR에 전달된 버퍼의 크기를 정의합니다 .

#define XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR 256

새 명령어

새 enum 상수

  • XR_KHR_EXTENDED_STRUCT_NAME_LENGTHS_EXTENSION_NAME
  • XR_KHR_extended_struct_name_lengths_SPEC_VERSION
  • XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR

버전 기록

  • 버전 1, 2024-02-29 (Matthew Langille)

    • 초기 확장 프로그램 설명

  • 버전 2, 2025-12-04 (Kenny Vercaemer)

    • 구조체 이름 길이 사양 수정