XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

ประเภทส่วนขยาย

ส่วนขยายอินสแตนซ์

หมายเลขต่อที่ลงทะเบียน

315

การแก้ไข

1

สถานะการให้สัตยาบัน

ยังไม่ได้รับการรับรอง

การขึ้นต่อกันของส่วนขยายและเวอร์ชัน

XR_ANDROID_trackables_qr_code

วันที่แก้ไขล่าสุด

2025-12-19

สถานะ IP

ไม่มีการอ้างสิทธิ์ใน IP ที่ทราบ

ผู้เขียน

Maximilian Mayer, Qualcomm

ภาพรวม

โครงสร้าง XrSystemQrCodeTrackingOperationsPropertiesQCOM มีคำจำกัดความดังนี้

typedef struct XrSystemQrCodeTrackingOperationsPropertiesQCOM {
    XrStructureType    type;
    void*              next;
    XrBool32           supportsQrCodeTrackingOperations;
} XrSystemQrCodeTrackingOperationsPropertiesQCOM;

คำอธิบายสมาชิก

• type
• next
• supportsQrCodeTrackingOperations

การใช้งานที่ถูกต้อง (โดยนัย)

• ต้องเปิดใช้ส่วนขยาย XR_QCOM_trackables_qr_code_operations ก่อนจึงจะใช้ XrSystemQrCodeTrackingOperationsPropertiesQCOM ได้
• type ต้องเป็น XR_TYPE_SYSTEM_QR_CODE_TRACKING_OPERATIONS_PROPERTIES_QCOM
• next ต้องเป็น NULL หรือพอยน์เตอร์ที่ถูกต้องไปยังโครงสร้างถัดไปในห่วงโซ่โครงสร้าง

โครงสร้าง XrTrackableQrCodeVersionFilterQCOM มีคำจำกัดความดังนี้

typedef struct XrTrackableQrCodeVersionFilterQCOM {
    XrStructureType    type;
    const void*        next;
    uint32_t           qrCodeVersionCount;
    uint32_t*          qrCodeVersions;
} XrTrackableQrCodeVersionFilterQCOM;

คำอธิบายสมาชิก

• type
• next
• qrCodeVersionCount
• qrCodeVersions

การใช้งานที่ถูกต้อง (โดยนัย)

• ต้องเปิดใช้ส่วนขยาย XR_QCOM_trackables_qr_code_operations ก่อนจึงจะใช้ XrTrackableQrCodeVersionFilterQCOM ได้
• type ต้องเป็น XR_TYPE_TRACKABLE_QR_CODE_VERSION_FILTER_QCOM
• next ต้องเป็น NULL หรือพอยน์เตอร์ที่ถูกต้องไปยังโครงสร้างถัดไปในห่วงโซ่โครงสร้าง
• qrCodeVersions ต้องเป็นตัวชี้ไปยังอาร์เรย์ของค่า qrCodeVersionCount uint32_t
• พารามิเตอร์ qrCodeVersionCount ต้องมากกว่า 0

โครงสร้าง XrTrackableQrCodeVersionQCOM มีคำจำกัดความดังนี้

typedef struct XrTrackableQrCodeVersionQCOM {
    XrStructureType    type;
    void*              next;
    uint32_t           qrVersion;
} XrTrackableQrCodeVersionQCOM;

คำอธิบายสมาชิก

• type
• next
• qrVersion

การใช้งานที่ถูกต้อง (โดยนัย)

• ต้องเปิดใช้ส่วนขยาย XR_QCOM_trackables_qr_code_operations ก่อนจึงจะใช้ XrTrackableQrCodeVersionQCOM ได้
• type ต้องเป็น XR_TYPE_TRACKABLE_QR_CODE_VERSION_QCOM
• next ต้องเป็น NULL หรือพอยน์เตอร์ที่ถูกต้องไปยังโครงสร้างถัดไปในห่วงโซ่โครงสร้าง

ฟังก์ชัน xrGetTrackableQrCodeRawDataQCOM มีคำจำกัดความดังนี้

XrResult xrGetTrackableQrCodeRawDataQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode,
    uint32_t                                    bufferCapacityInput,
    uint32_t*                                   bufferCountOutput,
    uint8_t*                                    buffer);

คำอธิบายพารามิเตอร์

• tracker
• qrCode
• bufferCapacityInput
• bufferCountOutput
• buffer

การใช้งานที่ถูกต้อง (โดยนัย)

• ต้องเปิดใช้XR_QCOM_trackables_qr_code_operationsส่วนขยายก่อนที่จะเรียกใช้ xrGetTrackableQrCodeRawDataQCOM
• tracker ต้องเป็นแฮนเดิล XrTrackableTrackerANDROID ที่ถูกต้อง
• bufferCountOutput ต้องเป็น Pointer ไปยังค่า uint32_t
• หาก bufferCapacityInput ไม่ใช่ 0 buffer ต้องเป็น Pointer ไปยัง อาร์เรย์ ของค่า bufferCapacityInput uint8_t

รหัสการคืนสินค้า

สำเร็จ

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ความล้มเหลว

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT
• XR_ERROR_VALIDATION_FAILURE

ฟังก์ชัน xrResetTrackableQrCodeTrackingQCOM มีคำจำกัดความดังนี้

XrResult xrResetTrackableQrCodeTrackingQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode);

คำอธิบายพารามิเตอร์

• tracker
• qrCode

การใช้งานที่ถูกต้อง (โดยนัย)

• ต้องเปิดใช้ส่วนขยาย XR_QCOM_trackables_qr_code_operations ก่อนที่จะเรียกใช้ xrResetTrackableQrCodeTrackingQCOM
• tracker ต้องเป็นแฮนเดิล XrTrackableTrackerANDROID ที่ถูกต้อง

รหัสการคืนสินค้า

สำเร็จ

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ความล้มเหลว

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_VALIDATION_FAILURE

ประวัติเวอร์ชัน

• การแก้ไขครั้งที่ 1, 19-12-2025

  • ตัวยึดตำแหน่ง