C Specification

The XrSurfaceAnchorCreateCompletionANDROID structure holds the result of an asynchronous surface anchor creation.

// Provided by XR_ANDROID_geospatial_anchor
typedef struct XrSurfaceAnchorCreateCompletionANDROID {
    XrStructureType         type;
    void*                   next;
    XrResult                futureResult;
    XrSpatialEntityIdEXT    anchorEntityId;
} XrSurfaceAnchorCreateCompletionANDROID;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain.

  • futureResult is the XrResult of the creation operation. If futureResult is XR_ERROR_GEOSPATIAL_CLOUD_AUTH_FAILED_ANDROID, a structure in the next chain may provide more information about the failure.

  • anchorEntityId is the XrSpatialEntityIdEXT of the created anchor, or XR_NULL_SPATIAL_ENTITY_ID_EXT if futureResult is not XR_SUCCESS.

Description

Future Return Codes

futureResult values:

Success

  • XR_SUCCESS

  • XR_SESSION_LOSS_PENDING

Failure

  • XR_ERROR_RUNTIME_FAILURE

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_OUT_OF_MEMORY

  • XR_ERROR_LIMIT_REACHED

  • XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID

  • XR_ERROR_SURFACE_ANCHOR_LOCATION_UNSUPPORTED_ANDROID

  • XR_ERROR_GEOSPATIAL_CLOUD_AUTH_FAILED_ANDROID

Valid Usage (Implicit)

See Also

XR_ANDROID_geospatial_anchor, XrResult, XrSpatialEntityIdEXT, XrStructureType, xrCreateSurfaceAnchorCompleteANDROID

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2026 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.