C Specification

The XrHapticParametricPropertiesEXT structure is defined as:

// Provided by XR_EXT_haptic_parametric
typedef struct XrHapticParametricPropertiesEXT {
    XrStructureType    type;
    void*              next;
    XrDuration         idealFrameSubmissionRate;
    XrDuration         minimumFirstFrameDuration;
    float              minFrequencyHz;
    float              maxFrequencyHz;
} XrHapticParametricPropertiesEXT;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

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

  • idealFrameSubmissionRate is the ideal rate the application should submit haptic frames with, in nanoseconds, for applications that generate haptic data on the fly.

  • minimumFirstFrameDuration is the minimum amount of haptic data, in nanoseconds, the application should submit in the first https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#ext_haptic_parametric-haptic-frame.

  • minFrequencyHz is the minimum frequency, in Hertz, supported by the haptic element.

  • maxFrequencyHz is the maximum frequency, in Hertz, supported by the haptic element.

Description

This structure contains properties about streaming timing and supported frequency range specific to a haptic element.

The runtime may populate idealFrameSubmissionRate with 0 if it has no restrictions on the https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#ext_haptic_parametric-haptic-frame submission rate. In this case, the application may freely choose any positive https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#ext_haptic_parametric-haptic-frame submission rate.

The runtime may populate minimumFirstFrameDuration with 0 if it has no restrictions on the minimum first https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#ext_haptic_parametric-haptic-frame duration. In this case, the application may freely choose the amount of haptic data in the first https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#ext_haptic_parametric-haptic-frame.

minFrequencyHz and maxFrequencyHz specify the absolute frequency range supported by the haptic element. The runtime may populate both with XR_FREQUENCY_UNSPECIFIED if it does not have the information. Otherwise, maxFrequencyHz must be minFrequencyHz or higher, and both values must be between XR_HAPTIC_PARAMETRIC_FREQUENCY_MIN_HZ_EXT and XR_HAPTIC_PARAMETRIC_FREQUENCY_MAX_HZ_EXT (inclusive).

Valid Usage (Implicit)

See Also

XR_EXT_haptic_parametric, XrDuration, XrStructureType, xrHapticParametricGetPropertiesEXT

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.